文档中心

ClickHouse Client

最近更新时间：2023.10.27 14:30:31

首次发布时间：2022.12.22 10:16:15

ClickHouse Client 是 ClickHouse 开源社区提供的命令行客户端，可以和 ByteHouse 集群进行完整的命令行交互。
本文介绍如何使用 ClickHouse 命令行工具连接到 ByteHouse 企业版集群。

前提条件

已创建 ByteHouse 集群，详见创建集群。
已设置 ByteHouse 密码，详见获取服务密码。
安装 clickhouse-client 工具，点此下载。

操作步骤

在 集群管理 > 集群列表 > 集群 > 连接集群 中查看到集群的连接信息，复制并修改其中的密码字段。连接语句基本语法如下。

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

执行连接命令，连接到 ByteHouse 集群。

clickhouse-client 使用的主要参数如下表，其他参数可参考官方文档 Command-line Client。

参数	说明
-C --config-file	指定客户端使用的配置文件
-h --host	指定 clickhouse-server 的 IP 地址
--port	指定 clickhouse-server 的端口地址
-u --user	用户名
--password	密码
-d --database	数据库名称
-V --version	查看客户端版本
-E --vertical	查询结果按照垂直格式显示
-q --query	非交互模式下传入的 SQL 语句
-t --time	非交互模式下显示执行时间
--log-level	客户端日志级别
--send_logs_level	指定服务端返回日志数据的级别
--server_logs_file	指定服务端日志保存路径

前提条件

操作步骤