wyndham-ARR/database/REMOTE_MIGRATION_20260728.md

ARR 测试数据库远程迁移记录

执行日期：2026-07-28
状态：完整迁移已提交并验收。

范围

• 源：<LEGACY_DB_HOST>:5433/booking_test，PostgreSQL 15.18
• 目标：<ARR_DB_HOST>:5432/booking_test，PostgreSQL 15.14
• 目标用户：<TEST_DB_OWNER>，数据库 owner，非超级用户
• 迁移对象：ingestion、booking、finance
• 源库处理：只读，未修改、未删除，继续保留作为临时回退

执行内容

• 应用 DDL：database/008_arr_mvp_v1_rebuild.sql
• DDL SHA-256：a29df928a2bcfca262216a9d53260528374b830266b3285f3687199cb802a530
• 基础表：14
• 视图：8
• 同步所有 identity sequence 的 last_value/is_called
• 迁移全部现有测试数据、处理审计和工件元数据

迁移前备份

• 目录：<PRIVATE_BACKUP_ROOT>/booking_test_pre_remote_migration_20260728T180747+0800
• manifest SHA-256：db8ca84fed52123d10151b475aca31659be237c6e7d513484e4f25b1d9a89c4d
• 备份权限：目录 0700，文件 0600
• 内容：14 表逐行 gzip JSON、schema/约束/索引/视图/函数/触发器/sequence 元数据、目标空库证据

安全执行

1. 只读确认目标 ARR schema 为空，用户为数据库 owner 且具备 CREATE。
2. 在目标执行一次完整 DDL + 全量复制 + 校验 + 强制 ROLLBACK 演练。
3. 第二连接确认演练后目标仍为空。
4. 正式执行相同流程，结构与数据在一个 SERIALIZABLE 事务内提交。
5. 任一步失败都会回滚；未发生部分提交。

最终一致性

• 双端结构 signature：0d64002b919d439dbbbbf78d1f5c5fab86d8f815f80dc6225f17a91ab5455e38
• 双端 14 表内容 hash bundle：42faf898d67b3015e85baf00bbd66a1fa4448d80daa7f5d9d0207a4004fad35c
• 双端逐表行数和逐表内容 SHA-256：全部一致
• identity sequence state：全部一致
• 未验证约束：0
• 目标 public 用户对象：0

关键数据计数：

表	行数
booking.source_rows	867
booking.parse_versions	867
booking.room_items	867
booking.current_row_parses	867
finance.daily_versions	1
finance.current_daily_versions	1
finance.daily_records	3
ingestion.artifacts	5
ingestion.processing_runs	2

Finance outcome：retained、duplicate、excluded_rate_code 各 1。

应用验收

使用新远程数据库实际运行：

• 渠道 BI：1 个渠道、1 条 retained；
• 渠道明细：1 行；
• 月报生成源：1 行；
• 公司报表：1 行，Booking Room 为 【DBL】1；
• Web 日报列表：1 条；
• Web 月度数据源投影：1 行。

当前配置

• 当前测试库配置：/path/to/private/booking-test-db.env（0600）
• 旧 LAN 回退配置：/path/to/private/booking-test-lan-db.env（0600）

文档不保存密码。应用应优先使用新远程配置；在观察期结束前不要删除旧 LAN 库。