Skip to content

Commit 76ee920

Browse files
authored
docs: Update Tableau support in SLS (#7121)
1 parent 88ef3d6 commit 76ee920

File tree

1 file changed

+39
-23
lines changed

1 file changed

+39
-23
lines changed

docs/docs-new/pages/product/workspace/semantic-layer-sync.mdx

Lines changed: 39 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ dimensions.
1919

2020
In general, here's how Cube entities match BI-specific ones:
2121

22-
| Cube | BI tool |
23-
| --------------------------- | ------------------------- |
24-
| Deployment, branch | Database |
25-
| Cube, view | Dataset, table |
26-
| Measure, dimension, segment | Column, dimension, metric |
22+
| Cube | BI tool |
23+
| --------------------------- | --------------------------- |
24+
| Deployment, branch | Database |
25+
| Cube, view | Dataset, table, data source |
26+
| Measure, dimension, segment | Column, dimension, metric |
2727

2828
## Creating syncs
2929

@@ -39,13 +39,14 @@ Follow the steps in the wizard to create a sync with any of supported BI tools.
3939

4040
Semantic Layer Sync supports the following BI tools:
4141

42-
- [Apache Superset](#creating-syncs-apache-superset) (self-hosted) and
43-
[Preset](#creating-syncs-preset) (managed)
44-
- [Metabase](#creating-syncs-metabase) (self-hosted and managed)
42+
- [Apache Superset](#apache-superset) (self-hosted) and
43+
[Preset](#preset) (managed)
44+
- [Metabase](#metabase) (self-hosted and managed)
45+
- [Tableau](#tableau) (Cloud and Desktop)
4546

4647
<InfoBox>
4748

48-
We're working on bringing support for more BI tools, e.g., Power BI and Tableau.
49+
We're working on bringing support for more BI tools, e.g., Power BI and MicroStrategy.
4950
Please [reach out to us](https://forms.gle/eEit9Pa7ZXSoFxb86) if you're
5051
interested in using Semantic Layer Sync with other BI tools.
5152

@@ -215,8 +216,7 @@ module.exports = {
215216
name: "Preset Sync",
216217
config: {
217218
api_token: "07988f63-c200-499e-97c9-ba137d8918aa",
218-
api_secret:
219-
"c19fbab4fd4945899795d32898f2e1165bef8e5ee653499e92f083b3d088aecb",
219+
api_secret: "c19fbab4fd4945899795d32898f2e1165bef8e5ee653499e92f083b3d088aecb",
220220
workspace_url: "12345678.us1a.app.preset.io",
221221
database: "Cube Cloud: production-deployment",
222222
},
@@ -262,12 +262,26 @@ sending them, or use a service account with a different email address:
262262

263263
### Tableau
264264

265-
Data model is synchronized via the [Tableau API][tableau-api] which uses either
266-
a `user` name and a `password`, or a personal access token and personal access
267-
token secret for authentication.
265+
Data model is synchronized via the [Tableau API][tableau-api] which uses [personal
266+
access tokens][tableau-pat] for authentication. You can create a new [personal access
267+
token][tableau-api-authentication] on the&nbsp;<Btn>My Account Settings</Btn> page.
268268

269-
You can learn more about creating personal access tokens in the [Tableau
270-
documentation][tableau-api-authentication].
269+
<InfoBox>
270+
271+
Personal access tokens might be disabled in your Tableau site configuration.
272+
To enable them, navigate to the&nbsp;<Btn>Settings</Btn> page of your Tableau site
273+
and click&nbsp;<Btn>Enable personal access tokens</Btn>.
274+
275+
By default, personal access tokens are configured with an expiry period of 180 days.
276+
Please check your Tableau site configuration for details. To customize the expiry
277+
period, navigate to the&nbsp;<Btn>Settings</Btn> page of your Tableau site. Please
278+
also make sure to renew your personal access token in time.
279+
280+
</InfoBox>
281+
282+
You will also need to specify a `region` and a Tableau `site` name. Consider the
283+
following URL of a Tableau site: `https://10ax.online.tableau.com/#/site/cubedev/home`.
284+
In this case, the region would be `10ax` and the site name would be `cubedev`.
271285

272286
Example `cube.js` configuration file for Tableau:
273287

@@ -279,25 +293,27 @@ module.exports = {
279293
type: "tableau",
280294
name: "Tableau Sync",
281295
config: {
282-
database: "My Database: production-deployment",
283-
site: "mytableausite",
284296
region: "10ax",
285-
286-
password: "******************",
287-
// Uncomment the following lines to use a personal access token instead of a username and password
288-
// personalAccessToken: "test",
289-
// personalAccessTokenSecret: "",
297+
site: "mytableausite",
298+
personalAccessToken: "cube-cloud",
299+
personalAccessTokenSecret: "HW8TFrBfJyen+JQleh0/bw==:1BvJLIti9Fud04rN021EfHMnh4yYD3p4",
300+
database: "Cube Cloud: production-deployment",
290301
},
291302
},
292303
];
293304
},
294305
};
295306
```
296307

308+
When connecting a Cube Cloud data source to your Tableau workbook, you will be prompted
309+
to enter the user name and password for Cube Cloud. You can find them at the&nbsp;<Btn>SQL
310+
API Connection</Btn> tab of the&nbsp;<Btn>BI Integrations</Btn> page in Cube Cloud.
311+
297312
[tableau-api]:
298313
https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm
299314
[tableau-api-authentication]:
300315
https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm#create-personal-access-tokens
316+
[tableau-pat]: https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm
301317

302318
## Running syncs
303319

0 commit comments

Comments
 (0)