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

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

交互模式下，一次登錄，可以執(zhí)行多次查詢。一般用不到，要查詢數據直接用客戶端軟件就行了，如DBeaver。

非交互模式一般用于使用腳本執(zhí)行查詢語句。

使用方式

clickhouse-client [參數]

配置參數

可以通過兩種方式來配置參數：

• 直接在命令行執(zhí)行參數
• 通過配置文件指定

命令行指定

• --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 – 如果指定，非交互模式下會打印查詢執(zhí)行的時間到stderr中。
• --stacktrace – 如果指定，如果出現(xiàn)異常，會打印堆棧跟蹤信息。
• --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="|"

執(zhí)行sql文件

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

更多說明

• 可以指定\G來替代分號或者在分號后面。每個字段的值會打印在不同的行中，數據列很多時比較友好。
• --format就是輸入輸出格式，常用的就是CSV，所有的格式見輸入輸出格式
• 在交互模式下，如果不指定-m參數，按Enter就執(zhí)行查詢了；如果要執(zhí)行多行查詢語句，需要在換行之前加上反斜杠\。指定了-m就不用加了。

參考

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

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

總結

以上是生活随笔為你收集整理的clickhouse-client命令行参数及常用案例的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。