This section describes how to connect and start querying data from Tableau.

Add the CData JDBC Driver for Square

Note: Before starting Tableau on Windows, make sure that you have placed the .jar file in the C:\Program Files\Tableau\Drivers folder. Before starting Tableau on macOS, make sure that you have placed the .jar file in the ~/Library/Tableau/Drivers folder.

To add the driver .jar file:

1. Start Tableau.
2. Under To a Server, select More.
3. Select Other Databases (JDBC).
4. Enter the JDBC connection string in the URL field. See Building the JDBC URL for Square below for more information.
5. Select Sign in.

Building the JDBC URL for Square

Connection strings provide information about a data source and how to connect to that data source. The driver comes with a connection string builder that makes it easier to create and manage the contents of connection strings.

After downloading and installing the driver, double-click the .jar file in the lib folder. You can also manually run the .jar file, as shown in the following examples.

From Windows:

java -jar 'C:\Program Files\CData\CData JDBC Driver for Square 2024\lib\cdata.jdbc.square.jar'

From macOS:

java -jar cdata.jdbc.square.jar

Running the .jar file opens the Connection Properties dialog box. You can use this dialog box to build and test a connection string. Click Test Connection to test and validate the entered connection properties. Click Copy to Clipboard to copy the connection string for use within the application where the JDBC driver is being used. See the help documentation for more information about the connection string options.

Discover Schemas and Query Data

To query data:

1. Select CData from the Database pull-down menu.
2. Select Odata from the Schema pull-down menu.
3. Drag the table onto the join area. You can include multiple tables.
4. Select Update Now or Automatically Update. Update Now lets you preview the first 10,000 rows of the data source (or enter the number of rows you want to see in the Rows text box). Automatically Update automatically reflects the changes in the preview area.
5. In the Connection menu, select the Live option, so that you skip loading a copy of the data into Tableau and instead work on real-time data.
6. Click the tab for your worksheet. Columns are listed as Dimensions and Measures, depending on the data type.