Connecting Tableau to Lakehouse

Tableau is a Business Intelligence (BI) product. Lakehouse supports connecting data to Tableau for visual analysis. You can leverage Tableau's simple drag-and-drop interface to customize views, layouts, shapes, colors, and more to present your own data perspective. This article explains how to connect Tableau using the Lakehouse JDBC driver and perform visual data analysis.

Background Information

Tableau Desktop is a software application developed by Tableau based on breakthrough technology from Stanford University. It helps you vividly analyze virtually any structured data and generate beautiful charts, graphs, dashboards, and reports within minutes. For more information about Tableau Desktop, see Tableau Desktop.

Prerequisites

Before starting, ensure you meet the following conditions:

  • Lakehouse service is activated.
  • Lakehouse JDBC Driver has been downloaded.
  • Tableau has been downloaded and installed. This article uses Professional Edition 2024.3.1 as an example.
  • The Lakehouse-provided Tableau Plugin

Connecting to Lakehouse

Step 1: Place the Lakehouse JDBC Driver

Place the downloaded Lakehouse JDBC Driver JAR file in the corresponding directory for Tableau Desktop based on your operating system:

  • Windows: C:\Program Files\Tableau\Drivers
  • macOS: ~/Library/Tableau/Drivers
  • Linux: /opt/tableau/tableau_driver/jdbc

Step 2: Place the Lakehouse Tableau Plugin

Download the Lakehouse-provided Tableau Plugin. This plugin is developed based on the Tableau official plugin documentation.

Place the downloaded plugin in the corresponding directory for Tableau Desktop:

  • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
  • macOS: /Users/[user]/Documents/My Tableau Repository/Connectors
  • Linux: /opt/tableau/connectors The example in this article uses macOS, with the location: /Users/xxx/Documents/My Tableau Repository/Connectors

Step 3: Launch Tableau

  1. Launch Tableau Desktop. Since the plugin above has not been digitally signed, signature verification must be disabled on startup.

-- Run on macOS command line /Applications/Tableau\ Desktop\[version].app/Contents/MacOS/Tableau -DDisableVerifyConnectorPluginSignature=true -- Run on Windows command line tableau.exe -DDisableVerifyConnectorPluginSignature=true

  1. In the left navigation bar under To Server, select More... > Lakehouse by Singdata.
  2. In Lakehouse by Singdata, configure the parameter information:
ParameterRequiredDescription
ServerYYou can find the JDBC connection string in Lakehouse Studio Administration -> Workspaces
UsernameYUsername
PasswordYPassword
  1. Click Sign In to enter the Tableau Desktop workspace.
  2. In the Schema dropdown list on the left, select the target Lakehouse Schema.

Step 4: Query and Analyze Data Using Tableau

This example uses the

clickzetta_sample_data.tpch_100g.orders
clickzetta_sample_data.tpch_100g.orders
table from the public dataset to analyze data.

Double-click New Custom SQL:

Enter the following and click OK:

select * from clickzetta_sample_data.tpch_100g.orders

Click Sheet to analyze the dataset from the

clickzetta_sample_data.tpch_100g.lineitem
clickzetta_sample_data.tpch_100g.lineitem
table: