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

Power BI

ClickHouse Supported

Microsoft Power BIは、ClickHouse Cloudまたはセルフマネージドデプロイメントからデータをクエリしたり、メモリに読み込んだりすることができます。

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

  • Power BI Desktop: ダッシュボードやビジュアライゼーションを作成するためのWindowsデスクトップアプリケーション
  • Power BI Service: Power BI Desktopで作成したダッシュボードをホストするためのSaaSとしてAzure内で利用可能

Power BIでは、デスクトップ版でダッシュボードを作成し、それを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データソース (64ビット)」を選択します。


ClickHouseドライバが一覧に表示されていることを確認します。


ClickHouseコネクタを探す​

注記

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

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


「ClickHouse」を検索します。


ClickHouseに接続する​

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

  • ホスト（必須） - インスタンスのドメイン/アドレス。接頭辞/接尾辞なしで追加してください。
  • ポート（必須） - インスタンスのポート。
  • データベース - データベース名。
  • オプション - ClickHouse ODBC GitHubページにリストされている任意のODBCオプション。
  • データ接続モード - DirectQuery

注記

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ビット)」を選択します。


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


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


接続情報を入力します。


注記

SSLが有効なデプロイ（例：ClickHouse Cloudまたはセルフマネージドインスタンス）を使用している場合は、SSLModeフィールドにrequireを指定する必要があります。

  • Hostには常にプロトコル（http://またはhttps://）を省略する必要があります。
  • Timeoutは秒で表される整数です。デフォルト値：30秒。

Power BIにデータを取得する​

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

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


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


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


注記

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


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


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

既知の制限事項​

UInt64​

UInt64やそれ以上の符号なし整数型は、自動的にデータセットに読み込まれないため、Int64がPower BIによってサポートされる最大の整数型です。

注記

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

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


完了したら、左上隅の「閉じて適用」をクリックし、データの読み込みを続けます。