@@ -19,11 +19,11 @@ dimensions.
1919
2020In 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
4040Semantic 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 .
4950Please [ reach out to us] ( https://forms.gle/eEit9Pa7ZXSoFxb86 ) if you're
5051interested 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  ; <Btn >Settings</Btn > page of your Tableau site
273+ and click  ; <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  ; <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
272286Example ` 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  ; <Btn >SQL
310+ API Connection</Btn > tab of the  ; <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