Power BI
Microsoft Power BI は、ClickHouse Cloud または自己管理型のデプロイメント環境からデータをクエリしたり、メモリ内にロードしたりできます。
データを可視化するために使用できる Power BI には、いくつかの形態があります。
- Power BI Desktop: ダッシュボードや可視化を作成するための Windows デスクトップアプリケーション
- Power BI Service: Power BI Desktop で作成したダッシュボードをホストするための SaaS として Azure 上で提供されるサービス
Power BI では、Desktop 版でダッシュボードを作成し、それを Power BI Service に公開する必要があります。
このチュートリアルでは、次の手順について説明します。
- ClickHouse ODBC ドライバーをインストールする
- ClickHouse Power BI Connector を Power BI Desktop にインストールする
- Power BI Desktop での可視化のために ClickHouse からデータをクエリする
- Power BI Service 用のオンプレミス データ ゲートウェイをセットアップする
前提条件
Power BI のインストール
このチュートリアルでは、Windows 環境に Microsoft Power BI Desktop がインストールされていることを前提とします。Power BI Desktop はこちらからダウンロードおよびインストールできます。
Power BI Desktop は最新バージョンに更新しておくことを推奨します。ClickHouse Connector は、バージョン 2.137.751.0 以降でデフォルトで利用可能です。
ClickHouse 接続情報の取得
ClickHouse インスタンスに接続するには、次の情報が必要です。
- Hostname - ClickHouse
- Username - ユーザー名
- Password - ユーザーのパスワード
- Database - 接続対象インスタンス上のデータベース名
Power BI desktop
Power BI Desktop でデータのクエリを開始するには、次の手順を実行します。
- ClickHouse ODBC ドライバをインストールする
- ClickHouse コネクタを探す
- ClickHouse に接続する
- データをクエリおよび可視化する
ODBC ドライバのインストール
最新の ClickHouse ODBC リリースをダウンロードします。
提供されている .msi インストーラを実行し、ウィザードに従います。
Debug symbols は任意であり、必須ではありません。
ODBC ドライバの確認
ドライバのインストールが完了したら、次の手順でインストールが正常に完了したことを確認できます。
スタートメニューで ODBC を検索し、「ODBC Data Sources (64-bit)」を選択します。
ClickHouse ドライバが一覧に表示されていることを確認します。
ClickHouse コネクタの検索
Power BI Desktop バージョン 2.137.751.0 で利用可能です。
Power BI Desktop のスタート画面で、「Get Data」をクリックします。
「ClickHouse」を検索します。
ClickHouse への接続
コネクタを選択し、ClickHouse インスタンスの認証情報を入力します。
- Host (必須) - インスタンスのドメイン/アドレス。プレフィックスやサフィックスを付けずに指定してください。
- Port (必須) - インスタンスのポート。
- Database - データベース名。
- Options - ClickHouse ODBC GitHub ページに記載されている任意の ODBC オプション。
- Data Connectivity mode - DirectQuery
ClickHouse に直接クエリする場合は、DirectQuery を選択することを推奨します。
データ量が少ないユースケースの場合は、インポート モードを選択することもでき、その場合はすべてのデータが Power BI に読み込まれます。
- ユーザー名とパスワードを指定します。
データのクエリおよび可視化
最後に、Navigator ビューにデータベースとテーブルが表示されます。目的のテーブルを選択し、「Load」をクリックして ClickHouse からデータをインポートします。
インポートが完了すると、ClickHouse のデータは他のデータと同様に Power BI から利用できるようになります。
Power BI サービス
Microsoft Power BI サービスを使用するには、オンプレミス データ ゲートウェイ を作成する必要があります。
カスタム コネクタの設定方法の詳細については、Microsoft のドキュメント「オンプレミス データ ゲートウェイでカスタム データ コネクタを使用する」を参照してください。
ODBC ドライバー（インポート専用）
DirectQuery を使用する ClickHouse Connector の使用を推奨します。
上記の手順に従って、オンプレミス データ ゲートウェイ インスタンスに ODBC ドライバー をインストールし、検証 してください。
新しいユーザー DSN を作成する
ドライバーのインストールが完了すると、ODBC データ ソースを作成できるようになります。スタート メニューで ODBC を検索し、「ODBC データ ソース (64 ビット)」を選択します。
ここで新しいユーザー DSN を追加する必要があります。左側の「追加」ボタンをクリックします。
ODBC ドライバーの Unicode バージョンを選択します。
接続情報を入力します。
SSL が有効なデプロイメント（例: ClickHouse Cloud やセルフマネージド インスタンス）を使用している場合は、SSLMode フィールドに require を指定する必要があります。
Hostには、常にプロトコル（http://やhttps://）を含めないでください。Timeoutは秒数を表す整数です。既定値:30 seconds。
Power BI にデータを取り込む
まだ Power BI をインストールしていない場合は、Power BI Desktop をダウンロードしてインストールしてください。
Power BI Desktop の開始画面で「データの取得」をクリックします。
「その他」 -> 「ODBC」を選択します。
先ほど作成したデータ ソースを一覧から選択します。
データ ソース作成時に認証情報を指定していない場合は、ユーザー名とパスワードの入力を求められます。
最終的に、ナビゲーター ビューにデータベースとテーブルが表示されます。目的のテーブルを選択し、「読み込み」をクリックして ClickHouse からデータをインポートします。
インポートが完了すると、通常どおり Power BI から ClickHouse のデータにアクセスできるようになります。
既知の制限事項
UInt64
UInt64 やそれより大きい符号なし整数型は、Power BI がサポートする最大の整数型が Int64 までであるため、自動的にはデータセットに読み込まれません。
データを正しくインポートするには、Navigator で「読み込み」ボタンを押す前に、「データの変換」を先にクリックしてください。
この例では、pageviews テーブルに UInt64 列があり、既定では「バイナリ」として認識されています。
「データの変換」をクリックすると Power Query Editor が開き、そこで列の型を再設定し、たとえば
テキストとして設定できます。
変更が完了したら、左上隅の「閉じて適用」をクリックし、データの読み込みに進みます。
