yandex/clickhouse-client

ClickHouse Client Docker镜像

镜像概述和主要用途

该镜像提供ClickHouse数据库管理系统的原生客户端，用于连接ClickHouse服务器并执行各类数据库操作，如查询执行、数据管理和系统配置等。更多信息可参考https://hub.docker.com/r/yandex/clickhouse-server/。

核心功能和特性

• 原生兼容性：与ClickHouse服务器完全兼容的官方客户端，支持所有原生协议和命令
• 轻量级部署：镜像体积小巧，启动快速，适合各类环境集成
• 完整功能支持：支持所有ClickHouse SQL语法、管理命令和数据操作
• 灵活交互方式：支持交互式终端模式和非交互式命令执行模式

使用场景和适用范围

• 命令行查询：开发人员和数据分析师通过命令行直接执行SQL查询
• 数据库管理：数据库管理员执行用户管理、权限配置和系统监控操作
• 自动化脚本：在Shell脚本或CI/CD流程中集成，实现数据处理自动化
• 临时连接：快速连接远程或本地ClickHouse服务器进行临时数据操作

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动客户端并连接到ClickHouse服务器：

bash
docker run -it --rm docker.xuanyuan.run/yandex/clickhouse-client --host <clickhouse-server-host> --port <port> --user <username> --password <password>

参数说明

• --host: ClickHouse服务器主机地址（默认值：localhost）
• --port: ClickHouse服务器TCP端口（默认值：9000）
• --user: 连接用户名（默认值：default）
• --password: 连接密码（默认值：空字符串）
• -it: 交互式终端模式，允许直接输入命令
• --rm: 容器退出后自动删除

非交互式查询执行

直接通过命令行参数执行SQL查询：

bash
docker run --rm docker.xuanyuan.run/yandex/clickhouse-client --host <host> --query "SELECT version(), currentDatabase();"

执行SQL文件

通过挂载本地SQL文件执行批量操作：

bash
docker run --rm -v /local/path/to/queries.sql:/queries.sql docker.xuanyuan.run/yandex/clickhouse-client --host <host> --password <password> --file /queries.sql

许可证

查看此镜像中包含软件的https://github.com/yandex/ClickHouse/blob/master/LICENSE。