datai/datai-scenes/datai-scene-salesforce/docs/changelog/0002-database-structure-adjustment.md
Kris 517284b614 feat: 实现Salesforce Pub/Sub API实时数据同步
主要变更:
- 新增PubSubConnectionFactory连接工厂,提供Pub/Sub API连接管理
- 新增PubSubEventSubscriberImpl实现,支持Pub/Sub API事件订阅
- 更新EventProcessorImpl,添加事件批次处理能力
- 更新RealtimeSyncService,使用Pub/Sub API替代CDC实现
- 更新Authentication.canvas架构文档,添加Pub/Sub组件
- 优化同步配置管理和实时同步日志功能

技术改进:
- 提升实时同步性能和可靠性
- 支持批量事件处理,提高吞吐量
- 完善连接工厂模式,统一管理连接生命周期
2026-01-12 10:31:25 +08:00

79 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 变更记录:数据库结构调整
## 变更信息
- **版本号**: v1.0.0
- **发布日期**: 2026-01-10
- **变更类型**: [特性更新]
## 变更摘要
本次变更主要涉及数据库结构的调整包括在现有的对象表中增加is_realtime_sync字段用于控制实时同步状态以及创建专门的实时同步日志表用于记录同步详情。这些数据库结构调整是支持Salesforce CDC实时同步功能的基础。
## 详细变更
### 特性更新
- **对象表结构扩展** - 在现有的对象表中增加`is_realtime_sync`字段tinyint(1)类型),用于标识该对象是否开启实时数据同步
- **实时同步日志表创建** - 创建专门的`datai_integration_realtime_sync_log`表,用于记录对象数据同步的详细信息
- **表结构优化** - 优化相关表结构,确保数据存储和查询效率
## 影响范围
### 受影响的模块
- **数据库模块** - 新增和修改表结构
- **对象管理模块** - 扩展对象表结构
- **同步日志模块** - 新增实时同步日志表
### 兼容性说明
- **向后兼容** - 本次变更不影响现有的表结构和数据
- **字段兼容性** - 新增的is_realtime_sync字段默认值为0未开启
## 升级指南
### 升级步骤
1. **备份数据库** - 在进行数据库结构调整前,备份现有数据库
2. **执行SQL脚本** - 执行数据库结构调整的SQL脚本
3. **验证表结构** - 验证表结构是否正确调整
4. **更新应用配置** - 更新应用配置以使用新的表结构
### 注意事项
- **数据备份** - 确保在调整表结构前备份所有相关数据
- **执行顺序** - 按照指定的顺序执行SQL脚本
- **验证测试** - 确保调整后的表结构能够正常工作
## 测试信息
### 测试环境
- **开发环境** - 本地开发环境,使用测试数据库
- **测试环境** - 测试服务器,使用测试数据库
### 测试结果
- **表结构创建测试** - 成功创建实时同步日志表
- **字段添加测试** - 成功在对象表中添加is_realtime_sync字段
- **数据存储测试** - 成功存储同步配置和日志数据
- **查询性能测试** - 验证查询性能符合要求
## 相关链接
- [需求文档](../requirements/0001-salesforce-realtime-sync.md) - Salesforce数据及时同步至本地数据库
- [设计文档](../design/0001-salesforce-cdc-realtime-sync.md) - Salesforce CDC实时同步设计
- [架构决策](../decisions/adr/0001-salesforce-cdc-sync.md) - Salesforce CDC同步方案
- [实时同步日志表SQL](../sql/create-realtime-sync-log-table.sql) - 实时同步日志表创建SQL
## 发布人员
- **开发人员** - 系统管理员
## 审核信息
- **审核人员**: 系统管理员
- **审核日期**: 2026-01-10
- **审核状态**: [通过]
- **审核意见**: 数据库结构调整符合设计要求is_realtime_sync字段类型为tinyint(1),实时同步日志表结构合理,能够满足实时同步的需求。