Skip to content

Commit 50871e2

Browse files
authored
docs: Add error message reference (#7093)
1 parent a176de9 commit 50871e2

File tree

3 files changed

+29
-3
lines changed

3 files changed

+29
-3
lines changed

docs/docs-new/pages/_meta.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ module.exports = {
2929

3030
product: {
3131
type: "page",
32-
title: "Docs",
32+
title: "Documentation",
3333
},
3434

3535
reference: {
Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
module.exports = {
22
"configuration": "Configuration",
3-
"frontend": "Frontend",
3+
"frontend": "JavaScript SDK",
44
"rest-api": "REST API",
55
"graphql-api": "GraphQL API",
66
"sql-api": "SQL API",
7-
"cli": "CLI"
7+
"cli": "CLI",
8+
"errors": "Error Messages"
89
}
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Error message reference
2+
3+
Working with Cube, you might encounter various error messages in logs and API responses.
4+
This page lists some of them with some practical advice on mitigation.
5+
6+
## `Can't find join path`
7+
8+
```
9+
Can't find join path to join 'cube_a', 'cube_b'
10+
```
11+
12+
Error message above indicates that a query failed because it includes members from cubes
13+
that can't be joined in order to generate a valid query to the upstream data source.
14+
15+
**Please check that you've defined necessary [joins](/product/data-modeling/reference/joins)
16+
and that they have [correct directions](/product/data-modeling/fundamentals/working-with-joins#transitive-join-pitfalls).**
17+
18+
Also, please consider using [views](/product/data-modeling/reference/view) since they
19+
incapsulate join paths and completely remove the possibility of the error in question.
20+
You might also consider setting [`public: false`](/product/data-modeling/reference/cube#public)
21+
on your cubes to hide them from end users.
22+
23+
If you’re building a custom data application, you might use the [`meta` endpoint](/reference/rest-api#v1meta)
24+
of the REST API. It groups cubes into `connectedComponents` to help select those ones
25+
that can be joined together.

0 commit comments

Comments
 (0)