ClickHouse

手記

このコネクタは ClickHouse, Inc. が所有し、提供しています。

概要

プロパティ Value
コネクタ ClickHouse アイコン ClickHouse
プロダクツ Power BI (セマンティック モデル)
Power Query Online
リリース状況 一般公開
Category Database
認証の種類 Basic
データソースの種類 ClickHouse
関数リファレンス ドキュメント ClickHouse.Database
サポート リンク サポート

手記

一部の機能は 1 つの製品に存在する可能性がありますが、展開スケジュールとホスト固有の機能のため、他の製品には存在しない場合があります。

前提 条件

  • 実行中の ClickHouse セットアップ。
  • コネクタを使用する前に、ClickHouse ODBC ドライバー をインストールする必要があります。

サポートされている機能

  • 輸入
  • DirectQuery (Power BI セマンティック モデル)

Parameters

エントリポイント:ClickHouse.Database

必須パラメーター数: 2

Power Query用 ClickHouse ODBC コネクタ

Parameter 表示名 Required タイプ 説明 サンプルの値 ヌラブル
サーバー Host イエス SMS 送信 ClickHouse ホストの名前 (名前のみ、プレフィックスなし) "play.clickhouse.com" false
ポート Port イエス 数値 ClickHouse で使用されるポート 443; 8123; 8443 false
データベース Database No null 許容テキスト ClickHouse データベースの名前 "default" true
オプション オプション No null 許容可能レコード セミコロンで区切られた追加の接続文字列オプション "Timeout=600;UseUnicode=true"; "UseUnicode=true" true

Power Query Desktop から接続する

  1. Power BI Desktop のスタート画面で、[データの取得] 選択します。

    Power BI Desktop の使用を開始する方法を示すスクリーンショット。

  2. ClickHouseを検索してください。

    データ ソースの選択のスクリーンショット。

  3. コネクタを選択し、次のボックスに入力します。

    • Server (必須フィールド): インスタンスのドメイン/アドレス。 必ずプレフィックスまたはサフィックスを付けずに追加してください。
    • ポート (必須フィールド): インスタンス ポート。
    • データベース: データベース名。
    • オプション: ClickHouse ODBC GitHub ページに記載されている任意の ODBC オプション。
    • データ接続モードの: ClickHouse に直接クエリを実行 DirectQuery を選択します。 負荷が小さい場合は、インポート モードを選択し、データ全体が Power BI に読み込まれます。

    ClickHouse インスタンス情報フィールドのスクリーンショット。

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

    ユーザー名とパスワードのプロンプトのスクリーンショット。

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

ナビゲーター ビューのスクリーンショット。

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

Power Query Online から接続する

ClickHouse コネクタと Power BI クラウド サービスの統合では、データ ゲートウェイを開始する必要があります。

データ ゲートウェイとは

オンプレミス データ ゲートウェイは、オンプレミスのデータ (クラウドにないデータ) と複数の Microsoft クラウド サービスの間で、迅速かつ安全なデータ転送を提供するためのブリッジとして機能します。 これらのクラウド サービスには、Power BI、PowerApps、Power Automate、Azure Analysis Services、Azure Logic Apps が含まれます。 ゲートウェイを使用することで、組織はオンプレミス ネットワーク上のデータベースやその他のデータ ソースを保持できる一方で、クラウド サービスでそのオンプレミス データを安全に使用できます。

このようなゲートウェイが必要な理由

追加のコンポーネント (ODBC ドライバーなど) を備えたカスタム コネクタと認定コネクタの両方で、追加のコンポーネントをエンド ユーザー コンピューターにインストールする必要があり、オンプレミス データ ゲートウェイが必要です。

統合に必要な手順:

  1. Power BI Desktop の使用状況に記載されているすべての手順に従います。
  2. データ ゲートウェイをインストールします。 詳細な手順については、「オンプレミス データ ゲートウェイをインストールする」を参照してください。
  3. ゲートウェイ で動作するように Power BI サービスを構成する方法については、この Microsoft の例従ってください。

詳細と例については、次のリソースを参照してください。