signoz/signoz-schema-migrator 执行 SigNoz 后端 ClickHouse schema 版本迁移，在 SigNoz 升级前后对齐表结构与物化视图。定位为 --rm 一次性迁移 Job，需配置 ClickHouse 连接与目标版本；SigNoz 小版本/大版本升级维护窗口中的 schema 对齐，迁移前须备份 ClickHouse 数据。

快速启动

docker run --rm \
  -e CLICKHOUSE_DSN=tcp://clickhouse:9000 \
  docker.io/signoz/signoz-schema-migrator:latest

推荐实践

docker run --rm \
  -e CLICKHOUSE_DSN=tcp://clickhouse:9000 \
  -e SIGNOZ_VERSION=0.55.0 \
  docker.io/signoz/signoz-schema-migrator:0.55.0

核心参数说明

• 定位 — 一次性 schema 迁移 Job
• CLICKHOUSE_DSN — ClickHouse 连接地址
• 顺序 — 停 write → migrate → 启 SigNoz 新版本
• 备份 — 迁移前备份 ClickHouse