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

ApsaraDB for ClickHouse:コマンドラインインターフェイスを使用したクラスターへの接続

最終更新日:Mar 10, 2026

このトピックでは、ClickHouse コマンドラインインターフェイスを使用して ApsaraDB for ClickHouse クラスターに接続する方法について説明します。

前提条件

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

  • データベースアカウントとパスワードが作成済みであること。詳細については、「アカウントの作成」をご参照ください。

  • お使いの ApsaraDB for ClickHouse クラスターのバージョンと一致する clickhouse-client ツールをインストールします。ツールのダウンロードについては、「clickhouse-client」をご参照ください。

  • clickhouse-client がインストールされているサーバーが ApsaraDB for ClickHouse クラスターと同じ VPC にない場合は、ApsaraDB for ClickHouse クラスターのパブリックエンドポイントをリクエストする必要があります。詳細については、「パブリックエンドポイントのリクエストとリリース」をご参照ください。

  • clickhouse-client がインストールされているサーバーの IP アドレスが ApsaraDB for ClickHouse のホワイトリストに追加済みであること。詳細については、「ホワイトリストの設定」をご参照ください。

操作手順

  1. clickhouse-client がインストールされているサーバーにログインします。

  2. 接続コマンドを実行して、ApsaraDB for ClickHouse クラスターに接続します。構文は次のとおりです。

    clickhouse-client --host=<host> --port=<port> --user=<user> --password=<password> 

    次の表にパラメーターを示します。

    パラメーター

    説明

    host

    パブリックエンドポイントまたは VPC エンドポイント。パブリックエンドポイントまたは VPC エンドポイントは、[クラスター情報] ページで確認できます。

    説明

    clickhouse-client をホストするサーバーが ApsaraDB for ClickHouse クラスターと同じ VPC にある場合は、VPC アドレスを使用して接続することを推奨します。同じ VPC にない場合は、パブリックエンドポイントを使用して接続することを推奨します。

    port

    TCP ポート番号。TCP ポート番号は、[クラスター情報] ページで確認できます。

    user

    データベースアカウント。

    password

    データベースアカウントのパスワード。