すべてのプロダクト
Search
ドキュメントセンター

Quick BI:ClickHouse データソースの追加

最終更新日:Jun 25, 2025

ClickHouse データソースを追加すると、ApsaraDB for ClickHouse データベースを Quick BI に接続できます。接続を確立すると、Quick BI でデータを分析および可視化できます。Quick BI は、インターネットまたは Alibaba Cloud VPC を介した ApsaraDB for ClickHouse への接続をサポートしています。このトピックでは、ApsaraDB for ClickHouse データソースを追加する方法について説明します。

前提条件

ApsaraDB for ClickHouse クラスターを作成済みであること。詳細については、「クラスターを作成する」をご参照ください。

背景情報

ApsaraDB for ClickHouse データベースを使用している場合は、データ分析のために Quick BI に接続するときに ClickHouse データソースを追加できます。

ClickHouse データソースが Quick BI に接続されている場合、データ接続とアクセスのネットワークタイプは、インターネットまたは Alibaba Cloud VPC のいずれかになります。

制限事項

  • ワークスペース管理者と開発者のみがデータソースを追加できます。

  • Professional Edition と Premium Edition のみ ClickHouse データソースの作成をサポートしています。

  • バージョン 20.3、22.8、および 23.8 がサポートされています。

手順

  1. ClickHouse データベースのホワイトリストを作成します。

    ApsaraDB for ClickHouse に接続する前に、Quick BI Quick BI の IP アドレス の IP アドレスを ApsaraDB for ClickHouse のホワイトリストに追加する必要があります。ApsaraDB for ClickHouse のホワイトリストに IP アドレスを追加する方法については、「ホワイトリストを構成する」をご参照ください。

  2. ApsaraDB for ClickHouse データソースを追加し、データソースに接続できることを確認します。

    1. Quick BI コンソール にログオンします。

    2. 次の図に示す手順を実行して、データソースを追加します。

      1. データソースを作成するためのエントリ から [データソースの作成] ページに移動します。

      2. Alibaba Cloud データベース タブで、[ClickHouse] データソースを選択します。

        image

  3. [接続の構成] ダイアログボックスで、ビジネスシナリオに基づいて構成を完了できます。image

    名前

    説明

    表示名

    データソースの名前。名前はデータソースリストに表示されます。

    名前に特殊文字を含めたり、スペースで開始または終了したりすることはできません。

    データベースアドレスポート

    ClickHouse データベースのパブリックエンドポイント。VPC データソースを使用する場合は、データベースの内部エンドポイントと内部ポートを入力します。

    ApsaraDB for ClickHouse コンソール にログオンし、[ネットワーク情報] セクションからデータベースアドレスを取得します。例: cc-xxxxxxxxxxxxxxxxxx.ads.rds.aliyuncs.com。

    データベース

    データベースをデプロイするときにカスタマイズされる ClickHouse データベースの名前。

    ユーザー名パスワード

    ClickHouse データベースへのアクセスに使用されるユーザー名とパスワード。

    タイムゾーン

    ClickHouse データベースがデプロイされているタイムゾーン。

    データベースバージョン

    ClickHouse データベースのバージョンを選択します。

    データベースバージョンが 23.8 以降の場合は、23.8 を選択します。データベースバージョンが 23.8 より前の場合は、22.8 を選択します。

    SSL

    宛先データソースで SSL が構成されている場合は、SSL セキュリティプロトコルを選択してデータセキュリティを保護できます。

    VPC データソース

    データベースが Alibaba Cloud VPC を使用している場合は、VPC データソース を選択し、次のパラメーターを構成します。

    • 購入者の AccessId: このインスタンスを購入したアカウントの AccessKey ID。詳細については、「AccessKey ペアを取得する」をご参照ください。

      説明

      AccessKey ID に宛先インスタンスに対する読み取り権限があることを確認してください。書き込み権限もある場合は、システムによって IP アドレスがホワイトリストに自動的に追加されます。それ以外の場合は、手動で IP アドレスを追加する必要があります。詳細については、「カスタムアクセス ポリシーを作成する」をご参照ください。

    • 購入者の AccessKey: このインスタンスを購入したアカウントの AccessKey Secret。詳細については、「AccessKey ペアを取得する」をご参照ください。

    • インスタンス ID:ClickHouse データベースインスタンスの ID。ApsaraDB for ClickHouse コンソールにログインし、クラスターリストからインスタンス ID を取得します。詳細については、「ClickHouse データソースの追加」をご参照ください。

    • リージョン: ClickHouse データベースインスタンスが配置されているリージョン。

    • インスタンスバージョン: インスタンスのバージョンを選択します。 [Enterprise Edition] または [Community Edition] を選択できます。

    説明

    VPC データソースを選択した場合は、データベースアドレスとポートに内部エンドポイントと内部ポートを入力する必要があります。

    初期 SQL

    この機能を有効にすると、データソースの接続後に初期化のために実行される SQL 文を構成できます。

    データソースが接続されるたびに初期化のために実行される SQL 文。SET 文のみが許可され、文はセミコロンで区切られます。

    ファイルのアップロードを有効にする

    この機能を有効にすると、ファイルのアップロードがサポートされます。

  4. [接続テスト] をクリックして、データソースの接続性をテストします。

    image

  5. テストが成功したら、[OK] をクリックします。

次の手順

データソースを追加した後、データセットを作成してデータを分析できます。