Dify 提供了双写和双读两个开关来确保存量用户平滑迁移:
双写机制(LOGSTORE_DUAL_WRITE_ENABLED):
- 默认关闭,设置为
True后系统会将日志同时写入 PG 和 SLS。 - 适用于迁移初期的灰度验证阶段,在不改变原有数据流的情况下,验证 SLS 的配置正确性和 Dify 版本升级的兼容性。
- 验证完成后可关闭双写,仅写入 SLS。
双读降级机制(LOGSTORE_DUAL_READ_ENABLED):
- 默认开启,系统优先从 SLS 读取日志。
- 如果 SLS 中未找到该记录(例如迁移前的老历史数据),插件会自动降级回 PG 再次尝试读取。
- 这确保了迁移过程中新旧数据都能被正常访问。
推荐的迁移步骤是:先开启双写进行灰度验证,确认无误后关闭双写,保持双读开启以兼容老数据,最终实现完全切换到 SLS。