- Power BI Desktop: ダッシュボードやビジュアライゼーションを作成するための Windows デスクトップアプリケーション
- Power BI サービス: Azure で利用できる SaaS で、Power BI Desktop で作成したダッシュボードをホストします
- ClickHouse ODBC ドライバのインストール
- Power BI Desktop への ClickHouse Power BI Connector のインストール
- Power BI Desktop で可視化するための ClickHouse データのクエリ
- Power BI サービス用のオンプレミス データ ゲートウェイの設定
2.137.751.0 以降でデフォルトで利用できます。
ClickHouseインスタンスに接続するには、次の情報が必要です。
- ホスト名 - ClickHouseのホスト名
- ユーザー名 - ユーザー認証情報のユーザー名
- パスワード - ユーザーのパスワード
- データベース - 接続先のインスタンス上のデータベース名
- ClickHouse ODBC ドライバをインストールする
- ClickHouse Connector を見つける
- ClickHouse に接続する
- データをクエリして可視化する
.msi インストーラーを実行し、ウィザードの指示に従います。

Debug symbols は任意で、必須ではありません
ClickHouse Driver が一覧に表示されていることを確認します。

Power BI Desktop のバージョン
2.137.751.0 で利用できます
「ClickHouse」を検索します

コネクタを選択し、ClickHouse インスタンスの認証情報を入力します。
- Host (必須) - インスタンスのドメインまたはアドレスです。プレフィックスや接尾辞を付けずに入力してください。
- Port (必須) - インスタンスのポートです。
- Database - データベース名です。
- Options - ClickHouse ODBC GitHub Page に記載されている任意の ODBC オプションです
- Data Connectivity mode - DirectQuery

ClickHouse に直接クエリする場合は、DirectQuery を選択することを推奨します。データ量が少ないユースケースでは、インポート モードを選択することもでき、その場合はデータ全体が Power BI に読み込まれます。
- ユーザー名とパスワードを指定します

最後に、Navigator ビューにデータベースとテーブルが表示されます。目的のテーブルを選択し、「Load」をクリックして ClickHouse からデータをインポートします。

インポートが完了すると、通常どおり Power BI で ClickHouse のデータにアクセスできるようになります。
Microsoft Power BI サービスを使用するには、オンプレミス データ ゲートウェイを作成する必要があります。 カスタム コネクタの設定方法について詳しくは、Microsoft のオンプレミス データ ゲートウェイでカスタム データ コネクタを使用する方法に関するドキュメントを参照してください。 DirectQuery を使用する ClickHouse Connector の利用を推奨します。 前述のとおり、ODBC ドライバをオンプレミス データ ゲートウェイ インスタンスにインストールし、確認してください。 ドライバのインストールが完了したら、ODBC データソースを作成できます。スタートメニューで ODBC を検索し、「ODBC Data Sources (64-bit)」を選択します。

ここで新しい User DSN を追加します。左側の「Add」ボタンをクリックしてください。

ODBC ドライバの Unicode 版を選択します。

connection details を入力します。

SSL が有効なデプロイメント (例: ClickHouse Cloud またはセルフマネージドのインスタンス) を使用している場合は、
SSLMode フィールドに require を指定してください。Hostには、プロトコル (http://またはhttps://) を含めないでください。Timeoutは秒数を表す整数です。デフォルト値:30 seconds。

“Other” -> “ODBC” を選択します。

一覧から、先ほど作成したデータソースを選択します。

データソースの作成時に認証情報を指定しなかった場合は、ユーザー名とパスワードの入力を求められます。

最後に、Navigator ビューにデータベースとテーブルが表示されます。目的のテーブルを選択し、“Load” をクリックして ClickHouse からデータをインポートします。

インポートが完了すると、通常どおり Power BI で ClickHouse のデータにアクセスできるようになります。 Power BI は、中程度のデータ量を扱う従来型の行ベースのデータベース向けに設計されています。大規模な ClickHouse (数十億行規模) を扱う場合は、最適なパフォーマンスを得るために特定のアーキテクチャパターンが必要です。 Power BI は、ネストしたサブクエリ、複雑な JOIN、実行時の変換を含む SQL クエリを自動生成します。これらのパターンは従来の SQL データベースでは効果的に機能しますが、ClickHouse のような大規模な列指向データベースに対するクエリでは非効率になることがあります。 大規模なデータセットに対する推奨アプローチ: 生のテーブルを直接クエリするのではなく、ダッシュボードの各可視化に対して専用の
materialized views を ClickHouse に作成してください。これにより、次の利点が得られます。
- データ量に関係なく一貫した高速パフォーマンス
- ClickHouse クラスターへの負荷を軽減
- コストの予測がしやすくなる
- 直近の詳細なダッシュボード向けの時間単位の集計
- 過去の傾向分析向けの日単位の集計
- 長期的なレポート向けの月単位のロールアップ
- アドホック分析に備えて、適切な有効期限 (TTL) を設定した生データを保持する
- クエリパターンに合った
ORDER BYキーを定義する - 時系列データにはパーティション化を利用する
- 効率的なルックアップのために、小規模なディメンションテーブルをディクショナリに変換する
- さらなるクエリ最適化のためにプロジェクションを活用する
データを正しくインポートするには、Navigator で “Load” ボタンをクリックする前に、まず “Transform Data” をクリックしてください。
pageviews テーブルに UInt64 のカラムがあり、デフォルトでは “Binary” として認識されます。
“Transform Data” をクリックすると Power Query Editor が開き、そこでカラムの型を再割り当てできます。たとえば、
Text
に設定できます。

完了したら、左上の “Close & Apply” をクリックして、データの読み込みに進んでください。