Skip to main content

​
Prerequisites

Before you connect, you must first do the following:
  • Connect a data source to your Connect AI account. See Connections for more information.
  • Generate a Personal Access Token (PAT) on the Settings page. Copy this down, as it acts as your password during authentication.
  • If you want to connect to a workspace rather than a data source, first Add a workspace to Workspaces.

​
Connect to Connect AI

To establish a connection from Tableau Cloud to the Connect AI Virtual SQL Server API, follow these steps.
1
Log in to Tableau Cloud.
2
On the Home tab, click New > Workbook.
Tableau Cloud New Connection
3
On the Connect to Data dialog, select the Connectors tab. In the connectors list, select Microsoft SQL Server.
Tableau Cloud Select Source
4
Enter the connection settings.
  • Server—enter the Virtual SQL Server endpoint and port separated by a comma: tds.cdata.com,14333
  • Database—enter the Connection Name of the Connect AI data source you want to connect to (for example, Salesforce1).
  • Authentication—leave this as username and password.
  • Username—enter your Connect AI username. This is displayed in the top-right corner of the Connect AI interface. For example, test@cdata.com.
  • Password—enter the PAT you generated on the Settings page.
  • Require SSL—leave this selected.
5
Click Sign In.
6
Once the connection succeeds, your data is available to use in your workbook. Follow these steps to access it:
7
In the Connections section of the data pane to the left of the workbook, select your connection.
8
In the Database section of the data pane, select the data source that you want to use. The tables for that data source populate in the Table section.
9
Drag your tables into the workbook space or perform queries as needed.

​
Modify a Connection

You can modify your connection by following these steps:
1
In your workbook, click the drop-down arrow next to your connection in the Connections section.
2
Select Edit Connection.
Tableau Cloud Edit Connection
3
Edit your connection details and click Sign In when you are finished.

​
Connect to a Workspace

To connect Tableau Cloud to a specific workspace in Connect AI, you specify the workspace name after the Connect AI username in the format of [your_email_address]@[workspace_name]:
Tableau Cloud Workspace
You can copy the Username from the Virtual SQL Server tab of the Endpoints dialog for your workspace and paste it in the Tableau Cloud Username field.
Tableau Cloud Endpoints

​
Learn More

For more information about Tableau Cloud, please see the Tableau Cloud help pages.