Show Table of Contents
This article describes how to connect Tableau to a MySQL database and set up the data source.
Before you begin, gather this connection information:
Name of the server that hosts the database you want to connect to
User name and password
Are you connecting to an SSL server?
(Optional) Initial SQL statement to run every time Tableau connects
This connector requires a driver to talk to the database. You might already have the required driver installed on your computer. If the driver is not installed on your computer, when you try to connect, Tableau displays an error message with a link to the Driver Download page where you can find driver links and installation instructions.
Start Tableau and under Connect, select MySQL. For a complete list of data connections, select More under To a Server. Then do the following:
Enter the name of the server that hosts the database.
Enter the user name and password.
Select the Require SSL option when connecting to an SSL server.
(Optional) Select Initial SQL to specify a SQL command to run at the beginning of every connection, such as when you open the workbook, refresh an extract, sign in to Tableau Server, or publish to Tableau Server. For more information, see Run Initial SQL.
Select Sign In.
If Tableau can't make the connection, verify that your credentials are correct. If you still can't connect, your computer is having trouble locating the server. Contact your network administrator or database administrator.
On the data source page, do the following:
(Optional) Select the default data source name at the top of the page, and then enter a unique data source name for use in Tableau. For example, use a data source naming convention that helps other users of the data source figure out which data source to connect to.
From the Database drop-down list, select a database or use the text box to search for a database by name.
Under Table, select a table or use the text box to search for a table by name.
Drag the table to the canvas, and then select the sheet tab to start your analysis.
Use custom SQL to connect to a specific query rather than the entire data source. For more information, see Connect to a Custom SQL Query.
Here is an example of a MySQL data source using Tableau Desktop on a Windows computer:
If you use Tableau Desktop on a Mac, when you enter the server name to connect, use a fully qualified domain name, such as mydb.test.ourdomain.lan, instead of a relative domain name, such as mydb or mydb.test.
Alternatively, you can add the domain to the list of Search Domains for the Mac computer so that when you connect, you need to provide only the server name. To update the list of Search Domains, go to System Preferences > Network > Advanced, and then open the DNS tab.
You can make the following changes before you start your analysis:
Click Add next to Connections. For more information, see Join Your Data.
If a connection you want is not listed, select Data > New Data Source to add a new data source. For more information, see Blend Your Data.
In the data grid, click Update Now to see the first 1,000 rows of your data.
If you add tables, remove tables, or make changes to the join conditions, click Update Now again to see your changes.
To have changes automatically reflect in the data grid, click Automatically Update.
Click the metadata grid button () to perform routine management tasks, such as hiding or renaming fields.
Select how you want to sort the columns in the grid or metadata grid from the Sort fields drop-down list. You can sort the fields by data source or table order.
In the data grid, sort the row values by clicking the sort button next to the column name.
Click the column drop-down arrow and select Hide.
Double-click the field name.
To revert back to the original name of the field, select a column or multiple columns, click the column drop-down arrow, and then select Reset Name.
If your data supports split, click the column drop-down arrow, and then select Split. In some cases, you need to check for Split on the Data pane in the worksheet. For more information, see Split a Field into Multiple Fields.
Click the column drop-down arrow and select Create calculated field.
Select the values in the grid and then press Ctrl+C (Command-C on a Mac).
Select the values, right-click, and then select Copy.
If your data supports it, select Live or Extract under Connection at the top of the data source page.
If you choose to create an extract, click the Edit link that appears to set up filters that define a subset of the data to include in the extract. For more information, see Extract Your Data.
Click Add in the upper-right corner of the data source page to add data source filters to control what data is included in the data source.
Set Up Data Sources – Add more data to this data source or prepare your data before you analyze it.
Build Charts and Analyze Data – Begin your data analysis.