このトピックでは、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 クラスターのホワイトリストに追加されていること。詳細については、「ホワイトリストを設定する」をご参照ください。
手順
clickhouse-client ツールがインストールされているサーバーにログオンします。
次のコマンドを実行して、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 にデプロイされていない場合は、インターネット経由の接続にパブリックエンドポイントを使用してクラスターに接続することをお勧めします。
portTCP ポート番号。
TCP ポート番号。[クラスター情報] ページで TCP ポート番号を表示します。
userデータベースアカウントのユーザー名。
passwordデータベースアカウントのパスワード。