Power BI

ClickHouse Supported

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

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

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

Power BIでは、デスクトップ版でダッシュボードを作成し、Power BI Serviceに公開する必要があります。

このチュートリアルでは、以下のプロセスについて説明します：

• ClickHouse ODBCドライバーのインストール
• Power BI DesktopへのClickHouse Power BIコネクタのインストール
• Power BI Desktopでの視覚化のためのClickHouseからのデータのクエリ
• Power BI Serviceのためのオンプレミスデータゲートウェイの設定

Prerequisites

Power BI Installation

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

Power BIの最新バージョンへのアップデートをお勧めします。ClickHouseコネクタはバージョン 2.137.751.0 から既定で利用可能です。

Gather your ClickHouse connection details

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

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

Power BI desktop

Power BI Desktopでデータのクエリを開始するには、以下の手順を完了する必要があります：

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

Install the ODBC Driver

最新のClickHouse ODBCリリースをダウンロードしてください。

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

注記

Debug symbols はオプションであり、必須ではありません

Verify ODBC driver

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

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

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

Find the ClickHouse Connector

注記

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

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

「ClickHouse」で検索します。

Connect to ClickHouse

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

• ホスト (必須) - あなたのインスタンスのドメイン/アドレス。プレフィックス/サフィックスなしで追加してください。
• ポート (必須) - あなたのインスタンスのポート。
• データベース - あなたのデータベース名。
• オプション - ClickHouse ODBC GitHubページに記載されている任意のODBCオプション。
• データ接続モード - DirectQuery

注記

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

データが少量のユースケースがある場合、インポートモードを選択し、すべてのデータがPower BIにロードされます。

• ユーザー名とパスワードを指定します。

Query and Visualise Data

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

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

Power BI service

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

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

ODBC driver (import only)

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

ODBCドライバーをオンプレミスデータゲートウェイインスタンスにインストールし、上記の手順に従って検証してください。

Create a new User DSN

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

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

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

接続詳細を入力します。

注記

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

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

Get data into Power BI

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

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

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

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

注記

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

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

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

Known limitations

UInt64

UInt64またはそれ以上の符号なし整数型は、Power BIでサポートされている最大の整数型であるInt64として自動的にデータセットにロードされないため、注意が必要です。

注記

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

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

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