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

ApsaraDB for ClickHouse:CLI を使用した ClickHouse クラスターへの接続

最終更新日:Jul 18, 2026

clickhouse-client を使用して、ApsaraDB for ClickHouse クラスターに接続できます。

前提条件

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

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

  • 互換バージョンの clickhouse-client をインストール済みです。ダウンロードリンクについては、「clickhouse-client」をご参照ください。

  • clickhouse-client を実行するサーバーが ApsaraDB for ClickHouse クラスターと同じ VPC にない場合は、事前にパブリックエンドポイントを申請してください。詳細については、「パブリックエンドポイントの申請とリリース」をご参照ください。

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

操作手順

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

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

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

    以下の表は、各パラメーターの説明です。

    パラメーター

    説明

    host

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

    説明

    clickhouse-client を実行するサーバーと ApsaraDB for ClickHouse クラスターが同じ VPC 内にある場合は、内部エンドポイントを使用してください。それ以外の場合は、パブリックエンドポイントを使用します。

    port

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

    user

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

    password

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