You need to enable JavaScript to run this app.
ByteHouse 企业版

ByteHouse 企业版

复制全文
使用 CLI 工具
ClickHouse Client
复制全文
ClickHouse Client

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

前提条件
  • 已创建 ByteHouse 企业版集群,操作详情请参见创建集群
  • 已设置并获取 ByteHouse 企业版集群密码,操作详情请参见获取账号与密码
  • 下载并安装 ClickHouse Client 工具:您可参考 ClickHouse 社区提供的安装方式,详情请参见安装 ClickHouse Client

操作步骤
  1. 登录 ByteHouse 企业版集群,通过集群管理 > 集群列表 > 集群名称 > 连接集群路径,查看并复制其中 ClickHouse Client 的连接命令示例,修改其中的密码字段。ByteHouse 提供了私网和公网连接示例,您可按需单击页签切换并复制对应的命令示例。
    Image
    连接语句基本语法说明如下:

    clickhouse client
      --host <host>     # ByteHouse 企业版连接地址
      --user <user>     # ByteHouse 企业版集群的用户名
      --password <password>   # Bytehouse 企业版集群的密码
    

    ByteHouse 连接示例已为您自动填充了连接地址、用户名,您仅需填写密码,密码获取方式请参见获取账号与密码

  2. 执行连接命令,连接到 ByteHouse 集群。
    Image

  3. 输入 SQL 命令并回车,可发送查询。
    以下为交互模式下的查询示例:
    Image

参数说明

ClickHouse Client 使用的主要参数如下表,其他参数可参考官方文档 ClickHouse 客户端

参数

说明

-C,--config-file

指定客户端使用的配置文件。需填写完整理解,如:/etc/clickhouse-client/config.xml

-h,--host

指定 ByteHouse 服务端的 IP 地址。

--port

指定 ByteHouse 服务端的端口地址。

-u,--user

指定登录 ByteHouse 服务端的用户名。

--password

指定登录用户名对应的密码。

-d,--database

指定链接后默认使用的数据库名称。若不指定,默认进入 default 数据库。

-V,--version

查看当前 ByteHouse 客户端的版本信息。

-E,--vertical

将查询结果按照垂直格式显示。

-q,--query

非交互模式下传入的 SQL 语句。
非交互模式下直接执行指定的 SQL 语句(示例:clickhouse-client -q "SELECT * FROM test_table LIMIT 10")。

-t,--time

非交互模式下执行 SQL 后,显示语句的执行耗时。

--log-level

设置客户端日志的级别。

--send_logs_level

指定服务端返回日志数据的级别。

--server_logs_file

指定服务端日志保存路径,例如:/tmp/server.log

最近更新时间:2026.01.07 19:48:20
这个页面对您有帮助吗?
有用
有用
无用
无用