如何在Linux命令行执行Docker中ClickHouse的脚本？

一、直接在容器外执行单条SQL命令 #

无需进入容器bash，直接通过docker exec调用容器内的clickhouse-client执行查询，两种常用方式：

1. 使用--query参数

docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client --query="SELECT 1 + 2;"

2. 使用-e参数（和MySQL逻辑一致）

docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client -e "SELECT 1 + 2;"

注意：这里用-i而非-it，仅需读取标准输入/输出，不需要交互式终端。

二、执行本地SQL脚本文件 #

将本地SQL脚本通过重定向或管道传入容器内的clickhouse-client：

1. 重定向方式

docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client < /path/to/your/sql/script.sql

2. 管道方式

cat /path/to/your/sql/script.sql | docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client

三、程序化备份ClickHouse数据（适配Sentry场景） #

针对Sentry的ClickHouse数据备份，推荐两种实用方案：

方案1：直接导出数据到本地文件 #

利用clickhouse-client的格式化输出功能，将指定表的数据导出到本地备份文件：

# 导出sentry_local_events表为CSV格式，按日期命名备份文件
docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client --query="SELECT * FROM sentry_local_events FORMAT CSV" > /backup/path/sentry_events_backup_$(date +%Y%m%d).csv

# 导出为Parquet格式（更高效的列式存储，节省空间）
docker exec -i sentry-self-hosted_clickhouse_1 clickhouse-client --query="SELECT * FROM sentry_local_events FORMAT Parquet" > /backup/path/sentry_events_backup_$(date +%Y%m%d).parquet

方案2：使用clickhouse-backup工具（官方推荐） #

如果容器内未预装clickhouse-backup，先进入容器安装：

docker exec -it sentry-self-hosted_clickhouse_1 bash
curl -s https://raw.githubusercontent.com/AlexAkulov/clickhouse-backup/master/install.sh | bash
exit

然后在容器外执行备份，将备份数据挂载到本地目录：

# 创建本地备份目录
mkdir -p /local/backup/clickhouse

# 执行全量备份，备份文件自动同步到本地目录
docker exec -v /local/backup/clickhouse:/var/lib/clickhouse/backup sentry-self-hosted_clickhouse_1 clickhouse-backup create full_backup_$(date +%Y%m%d)

注意事项 #

• 确认容器名称sentry-self-hosted_clickhouse_1正确，可通过docker ps命令验证
• 备份操作避开业务高峰，防止影响Sentry服务性能
• 定期验证备份文件的完整性和可用性，避免备份失效

内容的提问来源于stack exchange，提问作者Lajos Arpad