ClickHouse

ClickHouse JDBC 連接器可實現 Tableau 和 ClickHouse 資料表之間的無縫集成，方便您利用 Tableau 強大的可視化和分析功能分析 ClickHouse 中儲存的資料。

Requirements

• Tableau 2020.4+
• ClickHouse 20.7+

Tableau Desktop

1. Download the Clickhouse JDBC Driver (version 0.8.X required), and place the clickhouse-jdbc-0.8.X-shaded-all.jar to:
   • macOS: ~/Library/Tableau/Drivers
   • Windows: C:\Program Files\Tableau\Drivers
   • You need to create the folder if it doesn't already exist
2. Download the latest clickhouse-jdbc.taco from the Releases page, and place it to:
   • macOS: ~/Documents/My Tableau Repository/Connectors
   • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
3. Run Tableau Desktop
4. In Tableau Desktop: Connect ➔ To a Server ➔ ClickHouse JDBC by ClickHouse, Inc.

Tableau Prep Builder

1. Download the Clickhouse JDBC Driver (version 0.8.X required) and place the clickhouse-jdbc-0.8.X-shaded-all.jar to:
   • macOS: ~/Library/Tableau/Drivers
   • Windows: C:\Program Files\Tableau\Drivers
   • You need to create the folder if it doesn't already exist
2. Download the latest clickhouse-jdbc.taco from the Releases page and place it to:
   • macOS: ~/Documents/My Tableau Prep Repository/Connectors
   • Windows: C:\Users\[Windows User]\Documents\My Tableau Prep Repository\Connectors
3. Run Tableau Prep Builder
4. In Tableau Prep Builder: Connections ➔ + ➔ To a Server ➔ ClickHouse JDBC by ClickHouse, Inc.

Tableau Server

1. Download the Clickhouse JDBC Driver (version 0.8.X required) and place the clickhouse-jdbc-0.8.X-shaded-all.jar to:

   • Linux: /opt/tableau/tableau_driver/jdbc
   • Windows: C:\Program Files\Tableau\Drivers
   • You need to create the directory if it doesn't already exist
   • For Linux: make sure directory is readable by the "tableau" user. To do this:

     • Create the directory:

       sudo mkdir -p /opt/tableau/tableau_driver/jdbc
       

     • Copy the downloaded driver file to the location, replacing [/path/to/file] with the path and [driver file name] with the name of the driver you downloaded:

       sudo cp [/path/to/file/][driver file name].jar /opt/tableau/tableau_driver/jdbc
       

     • Set permissions so the file is readable by the "tableau" user, replacing [driver file name] with the name of the driver you downloaded:

       sudo chmod 755 /opt/tableau/tableau_driver/jdbc/[driver file name].jar
       

2. Download the latest clickhouse-jdbc.taco from the Releases page and place it into these folders on each node:

   • Linux: /opt/tableau/connectors
   • Windows: C:\Program Files\Tableau\Connectors

3. Restart the server.

   tsm restart
   

   • Note that whenever you add, remove, or update a connector, you need to restart the server to see the changes.

For more information, please visit the connector's GitHub repository