> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Tableau では、ClickHouse のデータベースとテーブルをデータソースとして使用できます。 # Tableau と ClickHouse を接続する export const ClickHouseSupportedBadge = () => { return
ClickHouse Supported
; }; export const Image = ({img, alt, size}) => { return {alt} ; }; ClickHouse は公式の Tableau Connector を提供しており、 [Tableau Exchange](https://exchange.tableau.com/products/1064) で紹介されています。 このコネクタは、ClickHouse の高度な [JDBCドライバー](/ja/integrations/language-clients/java/jdbc) をベースにしています。 このコネクタを使用すると、Tableau で ClickHouse のデータベースやテーブルをデータソースとして利用できます。この機能を有効にするには、 以下のセットアップガイドに従ってください。
## 利用前に必要な設定
1. 接続情報を確認します HTTP(S) で ClickHouse に接続するには、次の情報が必要です。 | Parameter(s) | Description | | -------------------------------------------------------- | --------------------------------------------------------- | | `HOST` and `PORT` | 通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合は 8123 です。 | | `DATABASE NAME` | デフォルトでは `default` という名前のデータベースがあります。接続先のデータベース名を使用してください。 | | `USERNAME` and `PASSWORD` | デフォルトのユーザー名は `default` です。用途に応じたユーザー名を使用してください。 | | ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。 | | | サービスを選択し、**Connect** をクリックします。 | | ClickHouse Cloud サービスの接続ボタン **HTTPS** を選択します。接続情報は `curl` コマンドの例として表示されます。 ClickHouse Cloud HTTPS 接続情報 セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。 2. Tableau Desktopをダウンロードしてインストールします。 3. `clickhouse-tableau-connector-jdbc` の手順に従って、互換性のあるバージョンのClickHouse JDBC ドライバーをダウンロードします。 [clickhouse-jdbc-X.X.X-all-dependencies.jar](https://github.com/ClickHouse/clickhouse-java/releases) JAR ファイルを必ずダウンロードしてください。このアーティファクトはバージョン `0.9.2` 以降で利用できます。 4. JDBC ドライバーを次のフォルダーに保存します (OS に応じて、フォルダーが存在しない場合は作成できます) 。 * macOS: `~/Library/Tableau/Drivers` * Windows: `C:\Program Files\Tableau\Drivers` 5. Tableau で ClickHouse のデータソースを設定し、データの可視化を始めましょう。
## Tableau で ClickHouse のデータソースを設定する
`clickhouse-jdbc` ドライバーのインストールと設定が完了したので、次は ClickHouse の **TPCD** database に接続する データソースを Tableau で定義する方法を見ていきましょう。 1. Tableau を起動します。 (すでに起動している場合は、再起動してください。) 2. 左側のメニューで、**To a Server** セクションの **More** をクリックします。利用可能なコネクタの一覧から **ClickHouse by ClickHouse** を検索します。 ClickHouse by ClickHouse オプションが強調表示されたコネクタ選択メニューを示す Tableau の接続画面
コネクタ一覧に **ClickHouse by ClickHouse** コネクタが表示されませんか？ 古いバージョンの Tableau Desktop が原因の可能性があります。 その場合は、Tableau Desktop をアップグレードするか、[コネクタを手動でインストール](#install-the-connector-manually)することを検討してください。 3. **ClickHouse by ClickHouse** をクリックすると、次のダイアログが表示されます。 ClickHouse JDBC コネクタの詳細とインストールボタンを示す Tableau のコネクタインストールダイアログ
4. **Install and Restart Tableau** をクリックします。アプリケーションを再起動します。 5. 再起動後、コネクタ名が完全な名称である `ClickHouse JDBC by ClickHouse, Inc.` として表示されます。これをクリックすると、次のダイアログが表示されます。 server、port、database、username、password の各フィールドを示す Tableau の ClickHouse 接続ダイアログ
6. 接続情報を入力します。 | Setting | Value | | -------- | ----------------------------------- | | Server | **プレフィックスや接尾辞を含まない ClickHouse ホスト** | | Port | **8443** | | Database | **default** | | Username | **default** | | Password | \*\*\*\*\*\* | ClickHouse Cloud を使用する場合は、安全な接続のために SSL チェックボックスを有効にする必要があります。
この ClickHouse database の名前は **TPCD** ですが、上記のダイアログでは **Database** を **default** に設定し、その後 次の手順で **Schema** に **TPCD** を選択する必要があります。 (これはコネクタの不具合による可能性が高く、この動作は 今後変わるかもしれませんが、現時点では database として **default** を使用する必要があります。) 7. **Sign In** ボタンをクリックすると、新しい Tableau ワークブックが表示されます。 データベース選択オプションを含む初期接続画面を示す新しい Tableau ワークブック
8. **Schema** ドロップダウンから **TPCD** を選択すると、**TPCD** 内のテーブル一覧が表示されます。 CUSTOMER、LINEITEM、NATION、ORDERS などを含む TPCD データベースのテーブルを示す Tableau のスキーマ選択画面
これで Tableau で可視化を作成する準備が整いました。
## Tableau で可視化を作成する
Tableau で ClickHouse のデータソースを設定できたので、次はデータを可視化してみましょう。 1. **CUSTOMER** テーブルをワークブックにドラッグします。カラムは表示されますが、データテーブルは空のままです。 CUSTOMER テーブルをキャンバスにドラッグするとカラムヘッダーは表示されるがデータは表示されていない Tableau ワークブック
2. **Update Now** ボタンをクリックすると、**CUSTOMER** の 100 行がテーブルに表示されます。 3. **ORDERS** テーブルをワークブックにドラッグし、2 つのテーブル間のリレーションシップのフィールドとして **Custkey** を設定します。 Custkey フィールドを使用して CUSTOMER テーブルと ORDERS テーブルの接続を示す Tableau のリレーションシップエディター
4. これで、**ORDERS** テーブルと **LINEITEM** テーブルがデータソースとして関連付けられ、このリレーションシップを使ってデータに関する疑問に答えられるようになります。ワークブック下部の **Sheet 1** タブを選択してください。 分析に利用可能な ClickHouse テーブルのディメンションとメジャーを表示している Tableau ワークシート
5. たとえば、特定の品目が各年にどれだけ注文されたかを知りたいとします。**ORDERS** の **OrderDate** を **Columns** セクション (横方向のフィールド) にドラッグし、次に **LINEITEM** の **Quantity** を **Rows** にドラッグします。Tableau は次の折れ線グラフを生成します。 ClickHouse データから年ごとの注文数量を示す Tableau の折れ線グラフ
それほど面白い折れ線グラフではありませんが、このデータセットはスクリプトで生成され、クエリ性能のテスト用に作られているため、TPCD データのシミュレートされた注文にはあまり大きな変動がありません。 6. たとえば、四半期ごとの平均注文金額 (ドル建て) を、配送方法 (航空便、郵便、船便、トラックなど) 別にも知りたいとします。 * **New Worksheet** タブをクリックして新しいシートを作成します * **ORDERS** の **OrderDate** を **Columns** にドラッグし、**Year** から **Quarter** に変更します * **LINEITEM** の **Shipmode** を **Rows** にドラッグします 次のように表示されるはずです。 列に四半期、行に配送方法を表示した Tableau のクロス集計ビュー
7. **Abc** の値は、メトリクスをテーブルにドラッグするまでスペースを埋めているだけです。**ORDERS** の \* *Totalprice*\* をテーブルにドラッグします。デフォルトの計算が **Totalprices** の **SUM** になっていることを確認してください。 四半期ごとおよび配送方法ごとの合計注文金額を示す Tableau のクロス集計
8. **SUM** をクリックし、**Measure** を **Average** に変更します。同じドロップダウンメニューから **Format** を選択し、\*\* Numbers\*\* を **Currency (Standard)** に変更します。 通貨形式で四半期ごとおよび配送方法ごとの平均注文金額を示す Tableau のクロス集計
これで完了です。Tableau を ClickHouse に正常に接続し、ClickHouse データを分析して可視化するための可能性が大きく広がりました。
## コネクタを手動でインストールする
コネクタが既定で含まれていない古いバージョンの Tableau Desktop を使用している場合は、以下の手順で手動インストールできます。 1. [Tableau Exchange](https://exchange.tableau.com/products/1064) から最新の taco ファイルをダウンロードします 2. taco ファイルを次の場所に配置します * macOS: `~/Documents/My Tableau Repository/Connectors` * Windows: `C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors` 3. Tableau Desktop を再起動します。正しく設定できていれば、`New Data Source` セクションにコネクタが表示されます。
## 接続と分析のヒント
Tableau-ClickHouse インテグレーションを最適化するための詳しい情報については、 [接続のヒント](/ja/integrations/connectors/data-visualization/tableau/tableau-connection-tips) と [分析のヒント](/ja/integrations/connectors/data-visualization/tableau/tableau-analysis-tips) を参照してください。
## テスト
このコネクタは [TDVT フレームワーク](https://tableau.github.io/connector-plugin-sdk/docs/tdvt) を用いてテストされており、現在のカバレッジは 97% です。
## 概要
汎用の ODBC/JDBC ClickHouse ドライバーを使用して Tableau を ClickHouse に接続することもできますが、この コネクタを使うと接続設定の手順を簡略化できます。コネクタに関する問題が発生した場合は、GitHub からお気軽にご連絡ください。