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

ApsaraDB for ClickHouse:ApsaraDB for ClickHouse の CLI を使用してクラスターに接続する

最終更新日:Mar 18, 2025

このトピックでは、ApsaraDB for ClickHouse の CLI を使用して ApsaraDB for 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 経由の接続の場合は内部エンドポイント。[クラスター情報] ページで、インターネット経由の接続用のパブリックエンドポイントまたは VPC 経由の接続用の内部エンドポイントを表示します。

    説明

    clickhouse-client ツールがインストールされているサーバーが ApsaraDB for ClickHouse クラスターと同じ VPC にデプロイされている場合は、VPC 経由の接続に内部エンドポイントを使用してクラスターに接続することをお勧めします。 clickhouse-client ツールがインストールされているサーバーが ApsaraDB for ClickHouse クラスターと同じ VPC にデプロイされていない場合は、インターネット経由の接続にパブリックエンドポイントを使用してクラスターに接続することをお勧めします。

    port

    TCP ポート番号。

    TCP ポート番号。[クラスター情報] ページで TCP ポート番号を表示します。

    user

    データベースアカウントのユーザー名。

    password

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