メインコンテンツまでスキップ
メインコンテンツまでスキップ

TableauをClickHouseに接続する

ClickHouseは公式のTableauコネクタを提供しており、 Tableau Exchangeで特集されています。 このコネクタは、ClickHouseの高度なJDBCドライバに基づいています。

このコネクタを使用すると、TableauはClickHouseのデータベースとテーブルをデータソースとして統合します。この機能を有効にするには、以下のセットアップガイドに従ってください。

使用前に必要なセットアップ​

  1. 接続詳細を収集する

    To connect to ClickHouse with HTTP(S) you need this information:

    • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

    • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

    • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

    The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

    ClickHouse Cloud service connect button

    Choose HTTPS, and the details are available in an example curl command.

    ClickHouse Cloud HTTPS connection details

    If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

    以下は、ClickHouseにHTTP(S)で接続するために必要な情報です：

    • HOSTとPORT: 通常、TLSを使用する場合はポートが8443、使用しない場合は8123です。

    • DATABASE NAME: デフォルトでは、defaultという名前のデータベースがあります。接続したいデータベースの名前を使用します。

    • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。使用ケースに適したユーザー名を使用します。

    ClickHouse Cloudサービスの詳細は、ClickHouse Cloudコンソールで確認できます。 接続するサービスを選択し、Connectをクリックしてください：

    ClickHouse Cloud service connect button

    HTTPSを選択すると、詳細はexample curlコマンドで確認できます。

    ClickHouse Cloud HTTPS connection details

    セルフマネージドのClickHouseを使用している場合は、接続の詳細がClickHouse管理者によって設定されます。

  2. Tableau Desktopをダウンロードしてインストールします。

  3. clickhouse-tableau-connector-jdbcの指示に従って、ClickHouse JDBCドライバの互換バージョンをダウンロードします。

注記

clickhouse-jdbc-X.X.X-all-dependencies.jar JARファイルをダウンロードしてください。このアーティファクトはバージョン0.9.2以降で利用可能です。

  1. JDBCドライバを以下のフォルダに保存します（OSに基づいており、フォルダが存在しない場合は作成できます）：
    • macOS: ~/Library/Tableau/Drivers
    • Windows: C:\Program Files\Tableau\Drivers
  2. TableauでClickHouseデータソースを設定し、データビジュアライゼーションを構築を開始しましょう！

TableauでClickHouseデータソースを設定する​

clickhouse-jdbcドライバをインストールして設定したので、ClickHouseのTPCDデータベースに接続するデータソースをTableauで定義する方法を見てみましょう。

  1. Tableauを起動します。（すでに実行している場合は、再起動してください。）

  2. 左側のメニューから、サーバーに接続セクションのその他をクリックします。利用できるコネクタ一覧でClickHouse by ClickHouseを検索します：

ClickHouse by ClickHouseオプションがハイライトされたコネクタ選択メニューを示すTableau接続画面

注記

コネクタ一覧にClickHouse by ClickHouseが表示されませんか？古いTableau Desktopバージョンが関係している可能性があります。 それを解決するために、Tableau Desktopアプリケーションをアップグレードするか、コネクタを手動でインストールすることを検討してください。

  1. ClickHouse by ClickHouseをクリックすると、次のダイアログが表示されます：
ClickHouse JDBCコネクタの詳細とインストールボタンを示すTableauコネクタインストールダイアログ

  1. インストールしてTableauを再起動をクリックします。アプリケーションを再起動します。
  2. 再起動後、コネクタは完全な名前を持ちます：ClickHouse JDBC by ClickHouse, Inc.。これをクリックすると、次のダイアログが表示されます：
サーバー、ポート、データベース、ユーザー名、パスワードのフィールドを示すTableau接続ダイアログ

  1. 接続詳細を入力します：

    設定値
    サーバーClickHouseホスト（接頭辞または接尾辞なし）
    ポート8443
    データベースdefault
    ユーザー名default
    パスワード****
注記

ClickHouseクラウドを使用する場合は、安全な接続のためにSSLチェックボックスを有効にする必要があります。


注記

私たちのClickHouseデータベースはTPCDと呼ばれていますが、上記のダイアログでデータベースをdefaultに設定し、次のステップでスキーマにTPCDを選択する必要があります。（これはコネクタのバグによる可能性があるため、この動作が変わる可能性がありますが、現状ではdefaultをデータベースとして使用する必要があります。）

  1. サインインボタンをクリックすると、新しいTableauワークブックが表示されます：
データベース選択オプションを持つ最初の接続画面を示す新しいTableauワークブック

  1. スキーマのドロップダウンからTPCDを選択すると、TPCDのテーブルのリストが表示されます：
CUSTOMER、LINEITEM、NATION、ORDERSなどのTPCDデータベーステーブルを示すTableauスキーマ選択画面

これでTableauでビジュアライゼーションを構築する準備が整いました！

Tableauでのビジュアライゼーション構築​

TableauにClickHouseデータソースが設定されたので、データを可視化してみましょう...

  1. CUSTOMERテーブルをワークブックにドラッグします。カラムが表示されますが、データテーブルは空です：
カラムヘッダーは表示されるがデータがない状態のCUSTOMERテーブルがキャンバスにドラッグされたTableauワークブック

  1. 今すぐ更新ボタンをクリックすると、CUSTOMERから100行がテーブルに入力されます。

  2. ORDERSテーブルをワークブックにドラッグし、2つのテーブルの関係フィールドとしてCustkeyを設定します：

Custkeyフィールドを使用してCUSTOMERとORDERSテーブルの接続を示すTableauリレーションシップエディタ

  1. 現在、データソースとしてORDERSとLINEITEMテーブルが関連付けられているので、この関係を使用してデータに関する質問に答えることができます。ワークブックの一番下にあるシート1タブを選択します。
分析のために利用可能なClickHouseテーブルからの次元とメジャーを示すTableauワークシート

  1. 特定の項目が各年にどれだけ注文されたかを知りたいとします。ORDERSからOrderDateを列セクション（横のフィールド）にドラッグし、次にLINEITEMからQuantityを行にドラッグします。Tableauは次の折れ線グラフを生成します：
ClickHouseデータから年ごとの注文数を示すTableau折れ線グラフ

非常に刺激的な折れ線グラフではありませんが、データセットはスクリプトによって生成され、クエリパフォーマンスをテストするために構築されたため、TCPDデータの模擬注文にはあまり変動がないことに気づくでしょう。

  1. 四半期ごとや出荷モード（航空、郵送、出荷、トラックなど）ごとの平均注文額（ドル）を知りたいとします：

    • 新しいワークシートタブをクリックして新しいシートを作成する
    • ORDERSからOrderDateを列にドラッグし、年から四半期に変更する
    • LINEITEMからShipmodeを行にドラッグする

次のような画面が表示されるはずです：

四半期を列、出荷モードを行として示すTableauクロス集計ビュー

  1. Abcの値は、テーブルにメトリックをドラッグするまで、そのスペースを埋めるためのものです。ORDERSからTotalpriceをテーブルにドラッグします。既定の計算はTotalpricesを合計することです：
四半期と出荷モードごとの合計価格を示すTableauクロス集計

  1. SUMをクリックしてメジャーを平均に変更します。同じドロップダウンメニューから形式を選択し、数字を**通貨（標準）**に変更します：
通貨形式で四半期と出荷モードごとの平均注文額を示すTableauクロス集計

素晴らしい！TableauをClickHouseに成功裏に接続し、ClickHouseデータの分析と可視化の新たな可能性を開きました。

コネクタを手動でインストールする​

デフォルトでコネクタが含まれていない古いTableau Desktopバージョンを使用している場合は、以下の手順に従って手動でインストールできます：

  1. Tableau Exchangeから最新のtacoファイルをダウンロードします
  2. tacoファイルを以下の場所に配置します：
    • macOS: ~/Documents/My Tableau Repository/Connectors
    • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
  3. Tableau Desktopを再起動します。セットアップが成功した場合、新しいデータソースセクションにコネクタが表示されます。

接続と分析のヒント​

Tableau-ClickHouse統合を最適化するためのさらなるガイダンスについては、 接続のヒントと分析のヒントをご覧ください。

テスト​

コネクタはTDVTフレームワークを使用してテストされており、現在97％のカバレッジ率を維持しています。

概要​

一般的なODBC/JDBC ClickHouseドライバを使用してTableauをClickHouseに接続できます。ただし、このコネクタは接続設定プロセスを簡素化しています。コネクタに関する問題がある場合は、GitHubでお問い合わせください。