Tableau Cloud
This guide covers connecting Tableau Cloud to Data Products, publishing semantic models, and creating workbooks.
Connect Tableau Cloud to turn your dimensions and measures into charts, dashboards, and drill-downs - no SQL required.
Tableau Cloud connects to your semantic layer through the MySQL wire protocol. Since the MySQL endpoint is hosted on a private network, Tableau Cloud uses Tableau Bridge to securely access your semantic models.
Getting Tableau Bridge and network access set up is a one-time, platform-admin-adjacent task, heavier than the one-time Tableau Desktop connection. If that setup isn't yours to do, loop in whoever administers Tableau Cloud and network access for your organization. Once it's done, publishing itself takes a few clicks from the Data Product page: no API calls required.
Prerequisites
Set these up once before connecting Tableau Cloud to your semantic models.
Enterprise Tableau Cloud
An active Tableau Cloud subscription.
Tableau Bridge
Required to connect Tableau Cloud to the DataOS MySQL proxy running on a private network. See more.
MySQL Connector/J
Version 9.2.0 specifically. Download from Maven Repository.
DataOS username
Your DataOS Id, found under Profile → Id.
DataOS API token
Generate from Profile → Tokens, or copy a token from Before you begin.
Tableau Personal Access Token (PAT) or Username and Password.
Required to publish semantic models to Tableau Cloud.
Before you begin (one-time setup)
Install Tableau Bridge
Download and install Tableau Bridge on a Windows or linux machine that has network access to your DataOS MySQL proxy.
Sign in using your Tableau Cloud account. After installation, ensure the Bridge status shows Connected.
Install the MySQL Connector/J driver
Tableau Bridge communicates with the DataOS MySQL proxy using the MySQL JDBC driver.
Download MySQL Connector/J 9.2.0 and copy the JAR file to the Tableau Drivers directory on the Bridge machine.
Windows
If the Drivers directory doesn't exist, create it.
Verify that the following file is available:
Important
The MySQL Connector/J JAR must be present on the Bridge machine. Tableau Bridge uses this driver to establish MySQL connections with the DataOS MySQL proxy.
Version 9.2.0 specifically. Other versions may not be compatible with the MySQL wire protocol used by DataOS.
Configure Tableau Bridge in Tableau Cloud
Open Tableau Cloud.
Navigate to:
Create a Bridge Pool
Open Pooling.
Click New Pool.
Provide a pool name.
Assign the Bridge computer to this pool.
Configure the Private Network Allowlist
Navigate to:
Click Add New Domain.
Enter your DataOS MySQL proxy domain.
Example:
Assign the domain to the Bridge Pool created in the previous step.
This allows Tableau Cloud to route all MySQL traffic through Tableau Bridge.
Get a Tableau Personal Access Token (optional)
The publish form authenticates to Tableau Cloud using either your Tableau Cloud username and password or a Personal Access Token (PAT). If you'll use your username and password, skip ahead to Publish the datasource section. To create a PAT instead:
Sign in to Tableau Cloud.
Click your Profile icon.
Select My Account Settings.
Scroll to Personal Access Tokens.
Click Create Token.
Enter a name.
Example:
Click Create Token.
Copy the generated Token Secret immediately.
If you'd rather use your Tableau Cloud login directly, no separate setup step is needed: just have your username and password ready.
1. Publish the datasource
From the Data Product page, go to Activate → BI Tools → Tableau Cloud and open the setup guide. Under Publish the datasource, fill in the form:
Project name
Optional. The Tableau Cloud project to publish into.
Server name *
Your Tableau Cloud server URL, e.g. https://10ax.online.tableau.com.
Site id *
Your Tableau Cloud site name.
Username/Password or Personal Access Token
Choose how you authenticate to Tableau Cloud.
Username * / Password *
Required when Username/Password is selected.
Token name * / Personal access token *
Required when Personal Access Token is selected.
Click Connect. Publishing runs against Tableau Cloud in real time, you'll see it in progress, then a success or failure outcome. On success, the datasource is available in your Tableau Cloud site's Explore list. On failure, nothing is published, and the form shows the error Tableau Cloud returned so you know what to fix.
2. Configure the connection
Once published, route the datasource through Tableau Bridge and confirm its live connection.
In Tableau Cloud, open Explore and open the published datasource.
Click ⋯ (More Options) and select Edit Connection.
Configure the connection using your DataOS credentials:
Click Save, then assign the datasource to the Bridge Pool you created earlier.
Your published datasource is now connected to DataOS through Tableau Bridge.
3. Build dashboards
Navigate to Explore.
Open the published datasource.
Click New Workbook.
Build your dashboards using the semantic models.
Publish the workbook to Tableau Cloud.
You're connected
Your semantic models are now available as a Tableau Cloud data source. You can create dashboards, stories, and visualizations directly on top of the semantic layer without redefining joins, measures, or business logic.
Limitations
Publishing a Workbook or Data Source from Tableau Desktop is currently not supported.
A data source published to Tableau Cloud cannot be connected back to Tableau Desktop.
Semantic models are published through the Tableau Cloud setup guide on the Data Product page, or the DataOS Tableau Publish API.
Tableau Bridge is required whenever the DataOS MySQL proxy is hosted on a private network.
The MySQL Connector/J 9.2.0 JAR must be installed on the Bridge machine.
If the semantic model changes, republish the data source to reflect the latest schema.
Troubleshooting
Data source not published
Check the error shown in the publish form. If publishing via the API, verify the response returns "status": "published".
Unable to connect
Ensure Tableau Bridge is online and assigned to the correct Bridge Pool.
Driver not found
Verify mysql-connector-j-9.2.0.jar exists under C:\Program Files\Tableau\Drivers\ on the Bridge machine.
Connection timeout
Verify tcp.<instance>.instance.dataos.cloud is added to the Private Network Allowlist and assigned to the Bridge Pool.
Authentication failed
Verify the DataOS username, DataOS API Token, Tableau PAT name, and PAT secret.
Personal Access Token missing
Ensure PATs are enabled for your Tableau Cloud site or contact your Tableau Site Administrator.
Cannot publish from Tableau Desktop
This is a current limitation. Publish semantic models using the Tableau Cloud setup guide on the Data Product page instead.
For data types, best practices, limitations, and governance, see the Tableau Cloud reference in References.
Last updated
Was this helpful?