Skip to content

Commit a3ec08e

Browse files
committed
New structure
1 parent 9956ad7 commit a3ec08e

File tree

9 files changed

+46
-36
lines changed

9 files changed

+46
-36
lines changed

docs/pages/product/apis-integrations.mdx

Lines changed: 27 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@ With a rich set of APIs, Cube can power and deliver data to all kinds of data
99
applications.
1010

1111
[Data APIs](#data-apis) are used to run queries against the data model.
12-
Despite using various transports and query formats, all data APIs share common
12+
Despite varying protocols and query formats, all data APIs share common
1313
[querying concepts][ref-queries].
1414

15-
<Diagram src="https://ucarecdn.com/023ca78a-aa96-493a-9799-95955a6d8948/" />
15+
<Diagram src="https://ucarecdn.com/d810360d-e23d-449c-9e25-097c2392d86d/" />
1616

1717
Also, there are [management APIs](#management-apis) to control Cube deployments
1818
externally.
@@ -23,23 +23,22 @@ externally.
2323

2424
A few rules of thumb to help you choose an API:
2525

26-
* When implementing internal or self-serve [business intelligence][cube-issbi] use
27-
case, pick the [SQL API][ref-sql-api] and [Semantic Layer Sync][ref-sls]. The
28-
SQL API allows querying Cube with a Postgres-compatible [dialect of
29-
SQL][ref-sql-syntax], either by writing queries manually or generating them with
30-
BI tools.
26+
* To connect to [Microsoft Power BI][ref-powerbi], use the [DAX API][ref-dax-api].
3127

32-
* To connect to Microsoft Excel, use the [MDX API][ref-mdx-api]. To connect to
33-
Google Sheets, use [Cube Cloud for Sheets][ref-cube-cloud-for-sheets].
28+
* To connect to [Microsoft Excel][ref-excel], use either the [MDX API][ref-mdx-api]
29+
or [Cube Cloud for Excel][ref-cube-cloud-for-excel].
3430

35-
* When implementing [embedded analytics][cube-ea] and [real-time
36-
analytics][cube-rta] use cases, pick [REST API][ref-rest-api] or [GraphQL
37-
API][ref-graphql-api]. Also, the [JavaScript SDK][ref-js-sdk] will simplify
38-
integration with your front-end code. The REST API uses a [JSON-based query
39-
format][ref-json-syntax], and the GraphQL API accepts [GraphQL
40-
queries][ref-graphql-syntax].
31+
* To connect to [Google Sheets][ref-sheets], use [Cube Cloud for Sheets][ref-cube-cloud-for-sheets].
4132

42-
* For AI use cases, consider using the [AI API][ref-ai-api].
33+
* For internal or self-serve [business intelligence][cube-issbi], use
34+
[Semantic Layer Sync][ref-sls] in case it supports your BI tools.
35+
Otherwise, connect via the [SQL API][ref-sql-api] directly.
36+
37+
* For [embedded analytics][cube-ea] and [real-time analytics][cube-rta], use
38+
[REST API][ref-rest-api] or [GraphQL API][ref-graphql-api]. When using the REST API,
39+
the [JavaScript SDK][ref-js-sdk] can simplify integration with your front-end code.
40+
41+
* For AI use cases, use the [AI API][ref-ai-api].
4342

4443
<ReferenceBox>
4544

@@ -53,21 +52,21 @@ for an unofficial, community-maintained [client library for Python](https://gith
5352
Support for data modeling features differ across APIs, integrations, and [visualization
5453
tools][ref-viz-tools]. Some of the features with partial support are listed below:
5554

56-
| Feature | Supported in | Not supported in |
55+
| Feature | Supported in | Not supported in |
5756
| --- | --- | --- |
58-
| [Hierarchies][ref-hierarchies] | [Tableau][ref-tableau] via [Semantic Layer Sync][ref-sls]<br/>Cube Cloud for Excel<br/>[Cube Cloud for Sheets][ref-cube-cloud-for-sheets] | All other tools |
59-
| [Folders][ref-folders] | [Tableau][ref-tableau] via [Semantic Layer Sync][ref-sls]<br/>✅ Cube Cloud for Excel<br/>✅ [Cube Cloud for Sheets][ref-cube-cloud-for-sheets] | All other tools |
57+
| [Hierarchies][ref-hierarchies] | [Microsoft Power BI][ref-powerbi] via the [DAX API][ref-dax-api]<br/>[Cube Cloud for Excel][ref-cube-cloud-for-excel]<br/>[Cube Cloud for Sheets][ref-cube-cloud-for-sheets]<br/>[Tableau][ref-tableau] via [Semantic Layer Sync][ref-sls] | All other tools |
58+
| [Folders][ref-folders] | [Cube Cloud for Excel][ref-cube-cloud-for-excel]<br/>[Cube Cloud for Sheets][ref-cube-cloud-for-sheets]<br/>[Tableau][ref-tableau] via [Semantic Layer Sync][ref-sls] | All other tools |
6059

6160
### Authentication methods
6261

6362
Support for authentication methods differ across APIs, integrations, and [visualization
6463
tools][ref-viz-tools]:
6564

66-
| Method | Supported in |
65+
| Method | Supported in |
6766
| --- | --- |
68-
| [User name and password][ref-auth-user-pass] | [SQL API][ref-sql-api] and [Semantic Layer Sync][ref-sls]<br/>[MDX API][ref-mdx-api] |
69-
| [Identity provider][ref-auth-idp] | Cube Cloud for Excel<br/>[Cube Cloud for Sheets][ref-cube-cloud-for-sheets] |
70-
| [Access token][ref-auth-tokens] | [REST API][ref-rest-api]<br/>[GraphQL API][ref-graphql-api]<br/>[AI API][ref-ai-api] |
67+
| [User name and password][ref-auth-user-pass] | [DAX API][ref-dax-api]<br/>[MDX API][ref-mdx-api]<br/>[Semantic Layer Sync][ref-sls]<br/>[SQL API][ref-sql-api] |
68+
| [Identity provider][ref-auth-idp] | [Cube Cloud for Excel][ref-cube-cloud-for-excel]<br/>[Cube Cloud for Sheets][ref-cube-cloud-for-sheets] |
69+
| [Access token][ref-auth-tokens] | [REST API][ref-rest-api]<br/>[GraphQL API][ref-graphql-api]<br/>[AI API][ref-ai-api] |
7170

7271
## Management APIs
7372

@@ -79,6 +78,7 @@ API][ref-orchestration-api].
7978
[cube-ea]: https://cube.dev/use-cases/embedded-analytics
8079
[cube-rta]: https://cube.dev/use-cases/real-time-analytics
8180
[ref-queries]: /product/apis-integrations/queries
81+
[ref-dax-api]: /product/apis-integrations/dax-api
8282
[ref-sql-api]: /product/apis-integrations/sql-api
8383
[ref-rest-api]: /product/apis-integrations/rest-api
8484
[ref-graphql-api]: /product/apis-integrations/graphql-api
@@ -87,13 +87,14 @@ API][ref-orchestration-api].
8787
[ref-orchestration-api]: /product/apis-integrations/orchestration-api
8888
[ref-sls]: /product/apis-integrations/semantic-layer-sync
8989
[ref-js-sdk]: /product/apis-integrations/javascript-sdk
90-
[ref-sql-syntax]: /product/apis-integrations/sql-api#querying-fundamentals
91-
[ref-json-syntax]: /product/apis-integrations/rest-api/query-format
92-
[ref-graphql-syntax]: /product/apis-integrations/graphql-api#getting-started
90+
[ref-cube-cloud-for-excel]: /product/apis-integrations/microsoft-excel
9391
[ref-cube-cloud-for-sheets]: /product/apis-integrations/google-sheets
9492
[ref-viz-tools]: /product/configuration/visualization-tools
9593
[ref-hierarchies]: /reference/data-model/hierarchies
9694
[ref-folders]: /reference/data-model/view#folders
95+
[ref-powerbi]: /product/configuration/visualization-tools/powerbi
96+
[ref-excel]: /product/configuration/visualization-tools/excel
97+
[ref-sheets]: /product/configuration/visualization-tools/google-sheets
9798
[ref-tableau]: /product/configuration/visualization-tools/tableau
9899
[ref-auth-user-pass]: /product/auth#user-name-and-password
99100
[ref-auth-idp]: /product/auth#identity-provider

docs/pages/product/apis-integrations/_meta.js

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
module.exports = {
22
"queries": "Queries",
3+
"dax-api": "DAX API",
4+
"mdx-api": "MDX API",
5+
"microsoft-excel": "Cube Cloud for Excel",
6+
"google-sheets": "Cube Cloud for Sheets",
37
"semantic-layer-sync": "Semantic Layer Sync",
48
"sql-api": "SQL API",
59
"rest-api": "REST API",
610
"graphql-api": "GraphQL API",
7-
"mdx-api": "MDX API",
8-
"google-sheets": "Cube Cloud for Sheets",
911
"ai-api": "AI API",
1012
"javascript-sdk": "JavaScript SDK",
1113
"orchestration-api": "Orchestration API",
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# DAX API
2+
3+
TODO
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
module.exports = {
2+
"reference": "Reference"
3+
}
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# DAX API function reference
2+
3+
TODO
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Cube Cloud for Excel
2+
3+
TODO

docs/pages/product/configuration/visualization-tools.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ page, please [file an issue](https://github.com/cube-js/cube/issues) on GitHub.
5454
/>
5555
<GridItem
5656
url="visualization-tools/powerbi"
57-
imageUrl="https://static.cube.dev/icons/powerbi.svg"
57+
imageUrl="https://static.cube.dev/icons/power-bi-dark.svg"
5858
title="Microsoft Power BI"
5959
/>
6060
<GridItem

docs/pages/product/configuration/visualization-tools/_meta.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@ module.exports = {
33
"bubble": "Bubble",
44
"budibase": "Budibase",
55
"deepnote": "Deepnote",
6-
"excel": "Excel",
76
"explo": "Explo",
87
"google-sheets": "Google Sheets",
98
"hashboard": "Hashboard",
@@ -14,8 +13,9 @@ module.exports = {
1413
"langchain": "LangChain",
1514
"looker-studio": "Looker Studio",
1615
"metabase": "Metabase",
16+
"excel": "Microsoft Excel",
17+
"powerbi": "Microsoft Power BI",
1718
"observable": "Observable",
18-
"powerbi": "Power BI",
1919
"push-ai": "Push.ai",
2020
"qlik-sense": "Qlik Sense",
2121
"quicksight": "QuickSight",

docs/pages/product/configuration/visualization-tools/powerbi.mdx

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,3 @@
1-
---
2-
redirect_from:
3-
- /config/downstream/powerbi
4-
---
5-
61
# Power BI
72

83
[Power BI](https://www.microsoft.com/en-gb/power-platform/products/power-bi/)

0 commit comments

Comments
 (0)