ClickHouse/docs/ja/integrations/data-visualization/powerbi-and-clickhouse.md

sidebar_label	slug	keywords	description
Power BI	/ja/integrations/powerbi	clickhouse powerbi connect integrate ui	Microsoft Power BIは、ビジネスインテリジェンスに主眼を置いてMicrosoftが開発したインタラクティブなデータ可視化ソフトウェア製品です。

import ConnectionDetails from '@site/docs/ja/_snippets/_gather_your_details_http.mdx';

Power BI

Power BIは、ODBCドライバーやClickHouseネイティブコネクタを使用して、ClickHouse Cloudまたはオンプレミスのデプロイメントからデータを読み込むことができます。どちらの方法もロードモードをサポートしていますが、後者はDirect Queryモードもサポートし、テーブル全体をロードする必要がありません。

このチュートリアルでは、これらの方法のどちらかを使用してデータを読み込むプロセスを案内します。

ClickHouseネイティブコネクタ

1. 接続情報を集める

2. ClickHouse ODBCクライアントをインストールする

最新のClickHouse ODBCリリースをこちらからダウンロードしてください。付属の.msiインストーラーを実行し、ウィザードに従ってください。"デバッグシンボル"はオプションで必要ありませんので、デフォルトのままで大丈夫です。

<img src={require('./images/powerbi_01.png').default} class="image" alt="ODBCドライバーのインストール" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_02.png').default} class="image" alt="新しいODBCデータソースの作成" style={{width: '50%', 'background-color': 'transparent'}}/>

ClickHouseドライバーがリストにあることを確認します。

<img src={require('./images/powerbi_03.png').default} class="image" alt="ODBCの存在確認" style={{width: '50%', 'background-color': 'transparent'}}/>

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

3. ClickHouseネイティブコネクタをインストールする

• カスタムコネクター用に次のディレクトリを作成します：[Documents]\Power BI Desktop\Custom Connectors
• 最新のリリース (.mezファイル) をReleases Sectionからダウンロードし、前のステップで作成したディレクトリに配置します。
• Power BIを開き、署名されていないコネクタの読み込みを有効にします：ファイル -> オプションと設定 -> オプション -> セキュリティ -> データ拡張 -> 警告なしまたは検証なしで任意の拡張機能をロードすることを許可

<img src={require('./images/powerbi_04.png').default} class="image" alt="署名されていないコネクタの読み込みを有効にする" style={{width: '50%', 'background-color': 'transparent'}}/>

• Power BIを再起動します。

4. Power BIにデータを取得する

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

<img src={require('./images/powerbi_05.png').default} class="image" alt="Power BI Desktopの開始" style={{width: '50%', 'background-color': 'transparent'}}/>

「ClickHouseConnector (Beta)」を検索します。

<img src={require('./images/powerbi_06.png').default} class="image" alt="データソースの選択" style={{width: '50%', 'background-color': 'transparent'}}/>

コネクタを選択し、次のボックスを埋めます：

• サーバー（必須フィールド） - インスタンスのドメイン/アドレス。プレフィックス/サフィックスなしで追加してください。
• ポート（必須フィールド） - インスタンスのポート。
• データベース - データベース名。
• オプション - ClickHouse ODBC GitHubページにリストされている任意のODBCオプション
• データ接続モード - ClickHouseに直接クエリを行うためにDirectQueryを選択します。小さな負荷がある場合は、インポートモードを選択し、データ全体をPower BIにロードすることができます。

<img src={require('./images/powerbi_07.png').default} class="image" alt="ClickHouseインスタンス情報の入力" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_08.png').default} class="image" alt="ユーザー名とパスワードのプロンプト" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_09.png').default} class="image" alt="Navigatorビュー" style={{width: '50%', 'background-color': 'transparent'}}/>

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

Power BIサービス

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

ODBCドライバー

上記のネイティブコネクタセクションのステップ1と2に従ってください。

3. 新しいユーザーDSNを作成する

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

<img src={require('./images/powerbi_02.png').default} class="image" alt="新しいODBCデータソースの作成" style={{width: '40%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_10.png').default} class="image" alt="新しいユーザーDSNの追加" style={{width: '40%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_11.png').default} class="image" alt="Unicodeバージョンの選択" style={{width: '40%', 'background-color': 'transparent'}}/>

接続情報を入力します。「ホスト」フィールドにはプロトコルを含めないでください（例： http:// や https:// 部分を省略）。ClickHouse Cloudを使用している場合やオンプレミスのデプロイメントでSSLが有効になっている場合、「SSLMode」フィールドにrequireと入力します。「タイムアウト」フィールド値は秒単位で設定され、省略された場合はデフォルト値の30秒になります。

<img src={require('./images/powerbi_12.png').default} class="image" alt="接続情報" style={{width: '30%', 'background-color': 'transparent'}}/>

4. Power BIにデータを取得する

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

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

<img src={require('./images/powerbi_05.png').default} class="image" alt="Power BI Desktopの開始" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_13.png').default} class="image" alt="データソースメニュー" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_14.png').default} class="image" alt="ODBCデータソースの選択" style={{width: '50%', 'background-color': 'transparent'}}/>

データソース作成時にすべての資格情報を指定した場合、すぐに接続するはずです。そうでない場合は、ユーザー名とパスワードを指定するよう求められます。

<img src={require('./images/powerbi_15.png').default} class="image" alt="Navigatorビュー" style={{width: '50%', 'background-color': 'transparent'}}/>

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

<img src={require('./images/powerbi_09.png').default} class="image" alt="Navigatorビュー" style={{width: '50%', 'background-color': 'transparent'}}/>

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

:::note UInt64などの符号なし整数型は、自動的にはデータセットにロードされません。Power BIでサポートされている最大の整数型はInt64です。
データを正しくインポートするには、Navigatorで「ロード」ボタンを押す前に、「データを変換」をクリックしてください。 :::

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

<img src={require('./images/powerbi_16.png').default} class="image" alt="Navigatorビュー" style={{width: '50%', 'background-color': 'transparent'}}/>

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