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

Power BI

Microsoft Power BIは、ClickHouse Cloudまたはセルフマネージドのデプロイメントからデータをクエリまたはメモリにロードできます。

データを視覚化するために使用できるPower BIのバリエーションはいくつかあります：

  • Power BI Desktop: ダッシュボードと視覚化を作成するためのWindowsデスクトップアプリケーション
  • Power BI Service: Power BI Desktopで作成したダッシュボードをホストするためにAzure内で利用可能なSaaS

Power BIでは、Desktopバージョンでダッシュボードを作成し、それをPower BI Serviceに公開する必要があります。

このチュートリアルでは、次のプロセスを案内します：

前提条件​

Power BIのインストール​

このチュートリアルでは、WindowsマシンにMicrosoft Power BI Desktopがインストールされていると仮定しています。Power BI Desktopはこちらからダウンロードしてインストールできます。

Power BIの最新バージョンへの更新をお勧めします。ClickHouseコネクタはバージョン 2.137.751.0 からデフォルトで利用可能です。

ClickHouse接続情報の収集​

ClickHouseインスタンスに接続するためには、以下の情報が必要です：

  • ホスト名 - ClickHouse
  • ユーザー名 - ユーザーの資格情報
  • パスワード - ユーザーのパスワード
  • データベース - 接続したいインスタンスのデータベース名

Power BI Desktop​

Power BI Desktopでデータのクエリを始めるには、次のステップを完了する必要があります：

  1. ClickHouse ODBCドライバーをインストール
  2. ClickHouseコネクタを見つける
  3. ClickHouseに接続
  4. データをクエリし、視覚化する

ODBCドライバーのインストール​

最新のClickHouse ODBCリリースをダウンロードします。

提供された.msiインストーラーを実行し、ウィザードに従います。

ODBCドライバーのインストール
注記

デバッグシンボルはオプションで、必須ではありません。

ODBCドライバーの確認​

ドライバーのインストールが完了したら、以下の方法でインストールが成功したかを確認できます：

スタートメニューでODBCを検索し、「ODBCデータソース (64-bit)」を選択します。

新しいODBCデータソースの作成

ClickHouseドライバーがリストに表示されているか確認します。

ODBCの存在確認

ClickHouseコネクタを見つける​

注記

Power BI Desktopのバージョン 2.137.751.0 で利用可能

Power BI Desktopのスタート画面で、「データを取得」をクリックします。

Power BI Desktopの開始

「ClickHouse」を検索します。

データソースの選択

ClickHouseに接続​

コネクタを選択し、ClickHouseインスタンスの資格情報を入力します：

  • ホスト (必須) - あなたのインスタンスのドメイン/アドレス。接頭辞や接尾辞を付けずに追加してください。
  • ポート (必須) - あなたのインスタンスのポート。
  • データベース - あなたのデータベース名。
  • オプション - ClickHouse ODBC GitHubページに記載されている任意のODBCオプション
  • データ接続モード - DirectQuery
ClickHouseインスタンス情報の入力
注記

ClickHouseに直接クエリを実行するにはDirectQueryを選択することをお勧めします。

データが少量の場合は、インポートモードを選択できます。そうすると、すべてのデータがPower BIにロードされます。

  • ユーザー名とパスワードを指定します。
ユーザー名とパスワードの入力プロンプト

データをクエリし、視覚化する​

最後に、ナビゲータービューにデータベースとテーブルが表示されるはずです。希望するテーブルを選択し、「ロード」をクリックしてClickHouseからデータをインポートします。

ナビゲータービュー

インポートが完了すると、ClickHouseデータは通常通りPower BIでアクセスできるようになります。


Power BI Service​

Microsoft Power BI Serviceを使用するには、オンプレミスデータゲートウェイを作成する必要があります。

カスタムコネクタの設定方法の詳細については、Microsoftのドキュメントを参照してください。オンプレミスデータゲートウェイでのカスタムデータコネクタの使用方法を確認してください。

ODBCドライバー (インポートのみ)​

DirectQueryを使用するClickHouseコネクタを使用することをお勧めします。

オンプレミスデータゲートウェイインスタンスにODBCドライバーをインストールし、上記に記載されているように確認します。

新しいユーザーDSNの作成​

ドライバーのインストールが完了すると、ODBCデータソースが作成できます。スタートメニューでODBCを検索し、「ODBCデータソース (64-bit)」を選択します。

新しいODBCデータソースの作成

ここで新しいユーザーDSNを追加する必要があります。左側の「追加」ボタンをクリックします。

新しいユーザーDSNの追加

ODBCドライバーのUnicodeバージョンを選択します。

Unicodeバージョンの選択

接続情報を入力します。

接続情報
注記

SSLが有効なデプロイメント (例: ClickHouse Cloudまたはセルフマネージドインスタンス) を使用している場合は、SSLModeフィールドにrequireを指定してください。

  • Hostには、必ずプロトコル（つまり、http://またはhttps://）を省略してください。
  • Timeoutは整数で、秒数を表します。デフォルト値: 30秒。

Power BIにデータを取り込む​

まだPower BIがインストールされていない場合は、Power BI Desktopをダウンロードしてインストールします。

Power BI Desktopのスタート画面で、「データを取得」をクリックします。

Power BI Desktopの開始

「その他」->「ODBC」を選択します。

データソースメニュー

リストから以前に作成したデータソースを選択します。

ODBCデータソースの選択
注記

データソースを作成する際に資格情報を指定しなかった場合、ユーザー名とパスワードを指定するように求められます。

ナビゲータービュー

最後に、ナビゲータービューにデータベースとテーブルが表示されるはずです。希望するテーブルを選択し、「ロード」をクリックしてClickHouseからデータをインポートします。

ナビゲータービュー

インポートが完了すると、ClickHouseデータは通常通りPower BIでアクセスできるようになります。

既知の制限事項​

UInt64​

UInt64などの符号なし整数型やそれ以上のサイズのものは、Power BIがサポートする最大の整数型であるInt64に自動的にロードされません。

注記

データを正しくインポートするには、ナビゲーターボタンで「ロード」ボタンを押す前に、「データの変換」をクリックしてください。

この例では、pageviewsテーブルにはUInt64カラムがあり、デフォルトで「バイナリ」として認識されます。 「データの変換」をクリックすると、Power Queryエディタが開き、列の型を再割り当てすることができるため、例えば、テキストとして設定します。

ナビゲータービュー

完了したら、左上隅の「閉じる & 適用」をクリックし、データのロードを続行します。