Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Requirement
Detail

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

  1. Open Pooling.

  2. Click New Pool.

  3. Provide a pool name.

  4. 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:

  1. Sign in to Tableau Cloud.

  2. Click your Profile icon.

  3. Select My Account Settings.

  4. Scroll to Personal Access Tokens.

  5. Click Create Token.

  6. Enter a name.

Example:

  1. Click Create Token.

  2. 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:

Field
Description

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.

Automate it: publish via the Metadata Export API

For scripted or CI publishing, call the same endpoint directly instead of using the form.

Replace every <...> placeholder with your actual environment and credentials before running a command.

Using a Personal Access Token

Windows PowerShell using a Personal Access Token

Run this command as one physical line.

Using Username & Password

Windows PowerShell using Username & Password

Run this command as one physical line.

Parameters

Parameter
Description

server_address

Tableau Cloud server URL

site_id

Tableau Cloud site name

token_name

Tableau Personal Access Token name (PAT auth only)

personal_access_token

Tableau Personal Access Token secret (PAT auth only)

username

Tableau Cloud username (username/password auth only)

password

Tableau Cloud password (username/password auth only)

Successful response

2. Configure the connection

Once published, route the datasource through Tableau Bridge and confirm its live connection.

  1. In Tableau Cloud, open Explore and open the published datasource.

  2. Click ⋯ (More Options) and select Edit Connection.

  3. Configure the connection using your DataOS credentials:

Field
Value

Username

Your DataOS username (Id)

Password

Network Type

Private Network

  1. 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

  1. Navigate to Explore.

  2. Open the published datasource.

  3. Click New Workbook.

  4. Build your dashboards using the semantic models.

  5. 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

Symptom
Resolution

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?