このトピックでは、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>;
下表に、各パラメーターを説明します。
パラメーター
説明
ホスト
インターネット経由の接続のパブリックエンドポイント、またはVPC経由の接続の内部エンドポイント。
[クラスター情報] ページで、インターネット経由の接続のパブリックエンドポイント、またはVPC経由の接続の内部エンドポイントを表示します。
説明clickhouse-clientツールがインストールされているサーバーがApsaraDB for ClickHouseクラスターと同じVPCにデプロイされている場合は、VPC経由の接続に内部エンドポイントを使用してクラスターに接続することを推奨します。 clickhouse-clientツールがインストールされているサーバーがApsaraDB for ClickHouseクラスターと同じVPCにデプロイされていない場合は、インターネット経由の接続にパブリックエンドポイントを使用してクラスターに接続することを推奨します。
ポート
TCPポート番号。
[クラスター情報] ページで、TCPポート番号を表示します。
ユーザー
データベースアカウントのユーザー名。
パスワード
データベースアカウントのパスワードを設定します。