ScyllaDB 零停机迁移实战从 Schema 对齐到灰度切流的四阶段拆解【免费下载链接】scylladbNoSQL data store using the Seastar framework, compatible with Apache Cassandra and Amazon DynamoDB项目地址: https://gitcode.com/GitHub_Trending/sc/scylladb周二凌晨三点订单查询表的 P99 告警把 DBA 从床上拽起来Cassandra 集群上延迟从 120ms 爬到 800mscompaction backlog 堆了 300GB。复盘会后的决定是——做零停机数据迁移把整个集群迁到 ScyllaDB业务侧不接受任何分钟级的服务窗口。这篇记录的就是这次 Cassandra 迁移 ScyllaDB 的完整过程工具链怎么搭、坑怎么踩的、数据怎么校出来的全部按实际发生的顺序来。先搞懂架构差异和几个关键性能数字ScyllaDB 是基于 Seastar 框架构建的 NoSQL 数据存储数据模型、CQL 方言和驱动生态与 Apache Cassandra 兼容。真正不同在执行模型每个 CPU 核心Shard跑一个独立的响应式线程I/O 走 Seastar 的非阻塞框架热路径上没有内核调度和线程池上下文切换的开销。直接后果是官方 YCSB benchmark 里同等硬件下 ScyllaDB 吞吐量约为 Cassandra 的 10 倍P99 延迟差距在数十倍量级官方 benchmark 参考值实际表现取决于你的负载形态。对迁移这件事意味着什么难点不在ScyllaDB 快不快而在业务不停写的前提下把数据搬过去。因为数据模型一致CQL 和驱动可以原样复用这是能平替的前提也是为什么迁移可以不动应用代码的读写协议层。ScyllaDB 数据迁移四阶段与阶段间依赖迁移不是一份顺序清单而是一条依赖链阶段 A 的前置校验漏一项阶段 C 灌数据时就报错阶段 B 双写不稳阶段 D 的数据校验就全是噪声。下面按阶段拆开重点讲每个阶段给下一阶段留下的条件。阶段 A前置校验与工具链搭建先查的不是工具是数据。三个必查项源集群版本有没有 Cassandra 2.0 时代遗留的表、是否开启磁盘静态加密、有没有计数器表。这三项分别对应后文三个大坑提前查到可以把返工成本从重灌一遍降到跳过某张表。工具链上官方明确建议不要在 ScyllaDB 集群节点上直接跑导入工具会吃掉目标集群资源。准备一台独立中间节点装scylla-tools-core确认它到两侧集群的 CQL 端口都通# 验证到 ScyllaDB CQL 端口的连通性 nc -zv scylla-node-1 9042 # 确认中间节点装的是 ScyllaDB 版工具和 Cassandra 的同名工具实现不同别混用 sstableloader --help阶段 BSchema 对齐与双写上线Schema 先导出、调整、再应用到 ScyllaDBcqlsh cassandra-ip -e DESC SCHEMA orig_schema.cql # 按官方兼容性文档逐项调整后导入 ScyllaDB cqlsh scylla-ip -f adjusted_schema.cql调整点是有限且可枚举的旧版参数如crc_check_chance在新版不认计数器表要看源版本坑点见后文不确定项以官方兼容性文档清单为准。Migrate to ScyllaDB 入口里挂了完整文档索引。双写的核心只有一条应用同时写两边读仍然只走 Cassandra。这里有个坑务必用客户端生成时间戳writetime。数据库各自生成时间戳的话两边时钟不同步同一个 key 可能在两侧留下不同版本都觉得自己赢的数据。最小可运行片段writes [ cass_session.execute_async(prepared, values), scylla_session.execute_async(prepared, values), ] for i, w in enumerate(writes): try: w.result() except Exception as e: discrepancy_queue.put((i, values, e)) # 差异入队别只打日志双写跑稳之后阶段 C 的依赖条件就成立了即使快照取在某个时间点之后的增量写入会持续追平。阶段 C用 sstableloader 灌入 TB 级存量数据这一步就是官方文档里的 forklifting先在源端做快照再用 ScyllaDB 的 sstableloader 通过 CQL API 把存量数据灌进去。实操细节有三个目录结构必须是.../[keyspace]/[table]形式sstableloader 靠路径的父目录解析表名拷文件时别拍平。-d可以列多个 ScyllaDB 节点做目标实测让所有节点同时接流吞吐接近线性。用-tMbit限速白天留给业务夜里放开比全程满速跑更不容易把网络打拥塞。# 源端对目标 keyspace 做快照 nodetool snapshot -t migration ks_orders # 灌入限速 2000Mbit sstableloader -d scylla-node-1,scylla-node-2 /mnt/snapshots/ks_orders/orders -t 2000失败处理没那么可怕导入任务以keyspace/表为单位失败重跑该表即可重复数据由 compaction 清掉源端某节点挂了RF1 时其他副本能顶上。另外注意当前官方文档已标注 sstableloader 处于弃用期推荐nodetool refresh --load-and-stream作为替代路径选型需以当前版本文档为准。灌之前还有两个表参数调整min_threshold设为 2让 compaction 更快清掉迁移产生的重复数据gc_grace_seconds调大官方建议 10 年量级防止 tombstone 在迁移期间被提前 GC。迁移完成后记得改回原值。阶段 D灰度切流与回滚兜底灌完别急着翻开关。应用切成双读单写每次读两边都查比对结果统计差异率。差异率低于业务阈值一般 0.1%并稳定 72 小时后读流量按 10% → 50% → 100% 灰度切。基础校验就一条语句-- 两边各跑一次比对近似值 SELECT COUNT(*) FROM ks_orders.orders;回滚兜底在切流前定好不是出事时现场想停双写 → TRUNCATE ScyllaDB 侧已灌入的表 → 应用切回 Cassandra → 重新快照、重新灌。官方文档把这条路径写成了清单建议直接做成 runbook 并演练一遍。三个最容易踩的坑格式不兼容、计数器表、双写时钟漂移加密文件灌不进去工具不会提前喊停的坑⚠️场景源集群开启了磁盘静态加密TDE照流程做完了快照。现象sstableloader 一读文件就报错进度停在 0。根因ScyllaDB 与 Cassandra 的加密备份文件互不兼容且 sstableloader 不支持从加密文件加载。文档写得很清楚但只核对SSTable 格式、不看加密的人必踩。处置把文件先上传回源集群用ALTER TABLE解密再执行nodetool upgradesstables重新生成可读的 SSTable然后重新快照灌入。绕路长但没有捷径。计数器表local counters 在 ScyllaDB 里不存在场景源集群是从 Cassandra 2.0 一路升级上来的统计类表用了 local counters。现象导入不报错但后续读计数器表时值不对或直接报错。根因ScyllaDB 支持 global counters2.1不支持 local counters2.0。如果你的源版本 ≥2.1这个坑天然不存在——它专坑 2.0 升级链路的集群。处置迁移前确认源的实际版本别信运维文档里的版本号。存在 2.0 local counters 的表不要硬迁要么改造成普通列重新建模要么单独换路径处理。双写丢数据的真相场景双写期间业务方反馈同一条记录两边值不一样。现象表面看像丢数据或写失败其实两边都有数据只是值不同。根因数据库各自生成时间戳时两个集群的时钟不会完全同步。同一个 key 的并发更新按 writetime 后到者胜于是两边各留了一个赢家。处置用客户端生成时间戳同一个请求在两侧带上同一个 writetime——这是官方文档明确推荐的姿势。同一 key 的并发更新用应用层分布式锁或 LWT轻量事务裁决别指望数据库替你商量。迁移之后的红利物化视图、二级索引与向量检索数据迁完回报才开始。Cassandra 时代需要建第二张表 应用双写来维护的能力现在一条语句就能表达。物化视图替代订单状态看板原订单表主键是(user_id, order_id)运营侧需要按status查询。以前我们得单独建一张 status 索引表应用层双写维护。现在直接CREATE MATERIALIZED VIEW ... WHERE status IS NOT NULLScyllaDB 自动维护存量数据迁移完成后索引自动回填应用查询代码只改个表名。二级索引救急查客服偶尔要按phone找人。给非主键列建索引正是 ScyllaDB 二级索引的用途。迁移时注意官方提醒sstableloader 只灌基础表索引数据不要导入让 ScyllaDB 自己建、自己回填。向量检索不用独立向量库ScyllaDB 内置了向量索引支持可看 vector_search/ 源码。团队做语义检索或推荐的话迁移后的集群可以直接试数据与业务查询在同一个库里省掉一套同步链路。下一步行动建议迁移收尾不是结束。三件事关注所用版本的 release notes——迁移相关工具行为比如 sstableloader 弃用随版本在变监控里加上双写差异率和compaction backlog两条告警回滚 runbook 和切流前的演练记录归档保存下次扩容或再迁移时能省下大量排查时间。细节流程可对照 Cassandra to ScyllaDB 迁移过程与 sstableloader 文档。【免费下载链接】scylladbNoSQL data store using the Seastar framework, compatible with Apache Cassandra and Amazon DynamoDB项目地址: https://gitcode.com/GitHub_Trending/sc/scylladb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考