clickhouse-client命令行参数及常用案例

ClickHouse提供了原生的命令行客户端clickhouse-client来操作ClickHouse。

clickhouse-client可以在交互和非交互（批处理）模式下使用。

交互模式下，一次登录，可以执行多次查询。一般用不到，要查询数据直接用客户端软件就行了，如DBeaver。

非交互模式一般用于使用脚本执行查询语句。

使用方式

clickhouse-client [参数]

配置参数

可以通过两种方式来配置参数：

直接在命令行执行参数
通过配置文件指定

命令行指定

--host, -h -– 服务端的host名称, 默认是localhost。可以选择使用host名称或者IPv4或IPv6地址。
--port – 连接的端口，默认值：9000。注意HTTP接口以及TCP原生接口使用的是不同端口。
--user, -u – 用户名。默认值：default。
--password – 密码。默认值：空字符串。
--query, -q – 使用非交互模式查询。
--database, -d – 默认当前操作的数据库. 默认值：服务端默认的配置（默认是default）。
--multiline, -m – 如果指定，允许多行语句查询（Enter仅代表换行，不代表查询语句完结）。
--multiquery, -n – 如果指定, 允许处理用;号分隔的多个查询，只在非交互模式下生效。
--format, -f – 使用指定的默认格式输出结果。
--vertical, -E – 如果指定，默认情况下使用垂直格式输出结果。这与–format=Vertical相同。在这种格式中，每个值都在单独的行上打印，这种方式对显示宽表很有帮助。
--time, -t – 如果指定，非交互模式下会打印查询执行的时间到stderr中。
--stacktrace – 如果指定，如果出现异常，会打印堆栈跟踪信息。
--config-file – 配置文件的名称。
--secure – 如果指定，将通过安全连接连接到服务器。
--history_file — 存放命令历史的文件的路径。

配置文件指定

通过配置文件指定时，使用下面列表中存在的第一个：

通过--config-file参数指定。
./clickhouse-client.xml
~/.clickhouse-client/config.xml
/etc/clickhouse-client/config.xml

配置文件实例

<config>
    <user>username</user>
    <password>password</password>
    <secure>False</secure>
</config>

使用案例

导入数据

cat data.csv | 
clickhouse-client --host 127.0.0.1 --port 9000 --database test_db --user default \
	 --password='123456' --query="INSERT INTO asd FORMAT CSV" --format_csv_delimiter="|";

导出数据

clickhouse-client --host 127.0.0.1 --port 9000 --database test_db --user default \
	--password='123456' --query="select * from asd limit 100"  --format CSV  --format_csv_delimiter="|"

执行sql文件

clickhouse-client --host 127.0.0.1 --port 9000 --database test_db --user default \
	 --password='123456'  --multiquery  < multi.sql

参考

clickhouse-client官方文档：https://clickhouse.tech/docs/zh/interfaces/cli/

format官方文档：https://clickhouse.tech/docs/zh/interfaces/formats/#formats

原文链接：https://blog.csdn.net/ifenggege/article/details/119958937