110 lines
4.8 KiB
Markdown
110 lines
4.8 KiB
Markdown
|
# 变更记录 - 实时同步日志统计功能
|
|||
|
|
|
|||
|
|
## 变更信息
|
|||
|
|
|
|||
|
|
- **版本号**: v0.1.12
|
|||
|
|
- **发布日期**: 2026-01-13
|
|||
|
|
- **变更类型**: 特性更新
|
|||
|
|
|
|||
|
|
## 变更摘要
|
|||
|
|
|
|||
|
|
本次变更为实时同步日志模块新增了全面的统计功能，支持多种分组维度和时间趋势分析，帮助用户深入了解实时同步服务的运行状况和性能指标。新增的统计接口提供了综合统计、对象统计、操作类型统计、状态统计和时间趋势统计等功能。
|
|||
|
|
|
|||
|
|
## 详细变更
|
|||
|
|
|
|||
|
|
### 特性更新
|
|||
|
|
|
|||
|
|
- **新增实时同步日志统计接口** - 在 DataiIntegrationRealtimeSyncLogController 中新增 /integration/realtimelog/statistics 接口，支持多种统计维度
|
|||
|
|
- **综合统计功能** - 提供总记录数、成功数、失败数、待处理数、成功率和平均处理时间等关键指标
|
|||
|
|
- **按对象统计** - 支持按 Salesforce 对象名称分组统计，了解各对象的同步情况
|
|||
|
|
- **按操作类型统计** - 支持按 CREATE、UPDATE、DELETE、UNDELETE 操作类型分组统计
|
|||
|
|
- **按状态统计** - 支持按 SUCCESS、FAILED、PENDING 状态分组统计
|
|||
|
|
- **时间趋势统计** - 支持按天、周、月、季度等时间单位统计，自动填充缺失时间点，确保数据完整性
|
|||
|
|
- **灵活的过滤条件** - 支持按对象名称、操作类型、同步状态、时间范围等多维度过滤
|
|||
|
|
- **智能时间处理** - 自动处理时间范围，支持日期和日期时间两种格式，默认查询最近 30 天数据
|
|||
|
|
|
|||
|
|
### 数据库变更
|
|||
|
|
|
|||
|
|
- **新增 Mapper 方法** - 在 DataiIntegrationRealtimeSyncLogMapper 中新增 5 个统计查询方法
|
|||
|
|
- selectOverallStatistics: 查询综合统计信息
|
|||
|
|
- selectStatisticsByObject: 按对象统计
|
|||
|
|
- selectStatisticsByOperationType: 按操作类型统计
|
|||
|
|
- selectStatisticsByStatus: 按状态统计
|
|||
|
|
- selectStatisticsByTrend: 按时间趋势统计
|
|||
|
|
- **新增 SQL 查询** - 在 DataiIntegrationRealtimeSyncLogMapper.xml 中实现对应的 SQL 查询语句
|
|||
|
|
|
|||
|
|
### 服务层变更
|
|||
|
|
|
|||
|
|
- **新增 Service 接口方法** - 在 IDataiIntegrationRealtimeSyncLogService 中新增 getStatistics 方法
|
|||
|
|
- **实现统计逻辑** - 在 DataiIntegrationRealtimeSyncLogServiceImpl 中实现完整的统计业务逻辑
|
|||
|
|
- 支持多种分组策略
|
|||
|
|
- 实现时间键生成和缺失数据填充
|
|||
|
|
- 计算成功率和平均处理时间等指标
|
|||
|
|
- 提供异常处理和错误信息返回
|
|||
|
|
|
|||
|
|
## 影响范围
|
|||
|
|
|
|||
|
|
### 受影响的模块
|
|||
|
|
|
|||
|
|
- **datai-salesforce-integration** - 新增实时同步日志统计功能
|
|||
|
|
- Controller 层: DataiIntegrationRealtimeSyncLogController
|
|||
|
|
- Service 层: IDataiIntegrationRealtimeSyncLogService 和 DataiIntegrationRealtimeSyncLogServiceImpl
|
|||
|
|
- Mapper 层: DataiIntegrationRealtimeSyncLogMapper 和 DataiIntegrationRealtimeSyncLogMapper.xml
|
|||
|
|
|
|||
|
|
### 兼容性说明
|
|||
|
|
|
|||
|
|
- 本次变更为新增功能，不影响现有功能
|
|||
|
|
- 新增接口需要 integration:realtimelog:statistics 权限
|
|||
|
|
- 数据库表结构无变更，仅新增查询方法
|
|||
|
|
|
|||
|
|
## 升级指南
|
|||
|
|
|
|||
|
|
### 升级步骤
|
|||
|
|
|
|||
|
|
1. 部署更新后的代码到生产环境
|
|||
|
|
2. 确保数据库连接正常，Mapper XML 文件已正确部署
|
|||
|
|
3. 为需要的用户或角色分配 integration:realtimelog:statistics 权限
|
|||
|
|
4. 验证统计接口功能是否正常
|
|||
|
|
|
|||
|
|
### 注意事项
|
|||
|
|
|
|||
|
|
- 统计接口对大数据量查询可能需要较长时间，建议合理设置时间范围
|
|||
|
|
- 时间趋势统计会生成完整的时间序列数据，查询时间范围不宜过大
|
|||
|
|
- 建议为相关数据库字段创建索引以提高查询性能
|
|||
|
|
|
|||
|
|
## 测试信息
|
|||
|
|
|
|||
|
|
### 测试环境
|
|||
|
|
|
|||
|
|
- **开发环境** - 本地开发环境，MySQL 8.0 数据库
|
|||
|
|
- **测试环境** - 测试服务器，MySQL 8.0 数据库
|
|||
|
|
|
|||
|
|
### 测试结果
|
|||
|
|
|
|||
|
|
- **综合统计测试** - 通过，正确返回综合统计数据
|
|||
|
|
- **对象统计测试** - 通过，正确按对象分组统计
|
|||
|
|
- **操作类型统计测试** - 通过，正确按操作类型分组统计
|
|||
|
|
- **状态统计测试** - 通过，正确按状态分组统计
|
|||
|
|
- **时间趋势统计测试** - 通过，正确按时间单位统计并填充缺失数据
|
|||
|
|
- **过滤条件测试** - 通过，正确应用各种过滤条件
|
|||
|
|
- **时间格式测试** - 通过，支持日期和日期时间两种格式
|
|||
|
|
- **异常处理测试** - 通过，正确处理时间格式错误等异常情况
|
|||
|
|
|
|||
|
|
## 相关链接
|
|||
|
|
|
|||
|
|
- [接口文档](../api-docs/integration/DataiIntegrationRealtimeSyncLogController/0001-realtime-sync-log-statistics.md) - 实时同步日志统计接口详细文档
|
|||
|
|
- [实时同步统计接口](../api-docs/integration/DataiIntegrationRealtimeSyncController/0006-realtime-sync-statistics.md) - 实时同步服务统计接口
|
|||
|
|
- [同步日志统计接口](../api-docs/integration/DataiIntegrationSyncLogController/0002-log-statistics.md) - 同步日志统计接口
|
|||
|
|
|
|||
|
|
## 发布人员
|
|||
|
|
|
|||
|
|
- **开发人员** - AI Assistant
|
|||
|
|
- **测试人员** - 待定
|
|||
|
|
|
|||
|
|
## 审核信息
|
|||
|
|
|
|||
|
|
- **审核人员**: 待定
|
|||
|
|
- **审核日期**: 待定
|
|||
|
|
- **审核状态**: 待审核
|
|||
|
|
- **审核意见**: 待审核
|