# 数据库【db_amazon_adv】文档 ## 一、数据库概述 ### 1.1 基本信息 - **数据库名称**: `db_amazon_adv` - **服务器版本**: 8.0.36 - **服务器操作系统**: Linux - **字符集**: utf8mb4 - **排序规则**: utf8mb4\_bin ### 1.2 数据库用途 这是一个亚马逊广告管理系统的数据库，主要用于： - 存储亚马逊广告相关的数据（SP、SD、HSA广告） - 管理广告活动、广告组、关键词、产品定位等广告实体 - 存储广告报告数据和性能指标 - 管理广告账户授权和配置 - 支持广告警告和提醒功能 - 数据同步和清理维护 ## 二、事件（EVENTS） ### 2.1 `db_timeout_process_kill` **调度规则**: 每天执行一次，起始时间：2024-06-14 16:44:41 **功能**: 1. 杀死运行时间超过20秒的SELECT查询 2. 从 `db_plum.t_amazon_group` 同步数据到 `t_amazon_group` ### 2.2 `delete_long_data` **调度规则**: 每天执行一次，起始时间：2024-06-14 16:45:01 **功能**: 清理历史数据 - 删除65天前的广告报告请求数据（SP广告保留8天） - 删除2天前的快照数据 - 删除7天前的汇总数据 ### 2.3 `groupSync` **调度规则**: 每分钟执行一次，起始时间：2025-02-17 11:22:13 **功能**: 从 `db_amazon.t_amazon_group` 同步群组数据到 `db_amazon_adv.t_amazon_group` ### 2.4 `syncData` **调度规则**: 每天执行一次，起始时间：2024-06-14 16:45:40 **功能**: 1. 更新未使用的广告授权状态 2. 同步群组、汇率数据 ## 三、数据表结构 ### 3.1 广告实体表 #### 3.1.1 广告活动相关 - `t_amz_adv_campaigns`: SP广告活动表 - `t_amz_adv_campaigns_hsa`: HSA广告活动表 - `t_amz_adv_campaigns_sd`: SD广告活动表 #### 3.1.2 广告组相关 - `t_amz_adv_adgroups`: SP广告组表 - `t_amz_adv_adgroups_hsa`: HSA广告组表 - `t_amz_adv_adgroups_sd`: SD广告组表 #### 3.1.3 关键词相关 - `t_amz_adv_keywords`: SP关键词表 - `t_amz_adv_keywords_hsa`: HSA关键词表 - `t_amz_adv_keywords_negativa`: 否定关键词表 #### 3.1.4 产品广告相关 - `t_amz_adv_productads`: SP产品广告表 - `t_amz_adv_productads_sd`: SD产品广告表 - `t_amz_adv_product_targe`: 产品定位表 ### 3.2 广告报告表 #### 3.2.1 SP广告报告 - `t_amz_adv_rpt2_sp_compaigns`: 广告活动报告 - `t_amz_adv_rpt2_sp_adgroups`: 广告组报告 - `t_amz_adv_rpt2_sp_keywords`: 关键词报告 - `t_amz_adv_rpt2_sp_productads`: 产品广告报告 #### 3.2.2 SD广告报告 - `t_amz_adv_rpt2_sd_campaigns`: SD广告活动报告 - `t_amz_adv_rpt2_sd_adgroups`: SD广告组报告 - `t_amz_adv_rpt2_sd_product_targets`: SD产品定位报告 #### 3.2.3 HSA广告报告 - `t_amz_adv_rpt2_hsa_campaigns`: HSA广告活动报告 - `t_amz_adv_rpt2_hsa_adgroups`: HSA广告组报告 - `t_amz_adv_rpt2_hsa_keywords`: HSA关键词报告 ### 3.3 基础配置表 #### 3.3.1 授权和账户 - `t_amz_adv_auth`: 广告授权表 - `t_amz_adv_profile`: 广告账户配置表 - `t_amz_advert_invoices`: 广告发票表 #### 3.3.2 广告物料 - `t_amz_adv_assets`: 广告素材表 - `t_amz_adv_brand`: 品牌表 - `t_amz_adv_media_hsa`: HSA媒体表 ### 3.4 业务管理表 #### 3.4.1 警告和提醒 - `t_advert_warning_keywords_data`: 关键词警告数据 - `t_advert_warning_product_data`: 产品警告数据 - `t_amz_adv_remind`: 广告提醒表 #### 3.4.2 定时任务 - `t_amz_adv_schedule_plan`: 广告定时计划 - `t_amz_adv_schedule_plandata`: 计划数据 - `t_amz_adv_schedule_planitem`: 计划项 ### 3.5 系统管理表 #### 3.5.1 运营管理 - `t_amz_adv_operate_log`: 操作日志表 - `t_amz_adv_remark`: 广告备注表 - `t_amz_adv_serch_history`: 搜索历史 #### 3.5.2 数据同步 - `t_amazon_group`: 亚马逊群组表 - `t_amz_adv_group`: 广告群组表 - `t_exchangerate`: 汇率表 ### 3.6 报表和快照 #### 3.6.1 报告管理 - `t_amz_adv_report_request`: 报告请求表 - `t_amz_adv_report_request_type`: 报告类型配置 - `t_amz_adv_snapshot`: 快照表 #### 3.6.2 数据汇总 - `t_amz_advert_report_summary`: 广告报告汇总 - `t_amz_adv_sumalltype`: 类型汇总统计 - `t_amz_adv_sumpdtads`: 产品广告汇总 ## 四、关键业务逻辑 ### 4.1 广告类型说明 - **SP**: 商品推广广告 - **SD**: 展示型广告 - **HSA**: 品牌推广广告 ### 4.2 数据保留策略 1. **报告数据**: 根据事件 `delete_long_data` 的清理规则 - SP广告报告保留8天 - 其他广告报告保留65天 - 快照数据保留2天 - 汇总数据保留7天 2. **数据同步**: 通过定时事件同步群组和汇率数据 ### 4.3 性能优化 1. **长查询处理**: 通过 `db_timeout_process_kill` 事件自动终止长时间运行的SELECT查询 2. **索引策略**: 所有主表都有合理的索引配置 3. **分区策略**: 部分报告表按日期分区 ## 五、表关系说明 ### 5.1 核心关系链
text
``` t_amz_adv_auth (授权) ↓ t_amz_adv_profile (账户配置) ↓ t_amz_adv_campaigns (广告活动) ↓ t_amz_adv_adgroups (广告组) ↓ t_amz_adv_keywords / t_amz_adv_productads (关键词/产品广告) ```
### 5.2 报告数据流
text
``` t_amz_adv_report_request (请求报告) ↓ t_amz_adv_snapshot (生成快照) ↓ t_amz_adv_rpt2_* (存储报告数据) ↓ t_amz_advert_report_summary (汇总统计) ```
## 六、维护建议 ### 6.1 监控建议 1. 监控事件执行状态 2. 监控长查询数量 3. 监控磁盘空间使用情况 4. 监控数据同步延迟 ### 6.2 备份策略 1. 业务数据每天备份 2. 配置数据变更时立即备份 3. 报告数据可根据业务重要性制定备份策略 ### 6.3 性能优化 1. 定期分析慢查询日志 2. 监控索引使用效率 3. 根据业务增长调整事件调度频率 ## 七、注意事项 ### 7.1 数据一致性 1. 广告授权状态与账户配置需保持同步 2. 群组数据需通过事件同步，避免直接修改 3. 汇率数据需定期更新 ### 7.2 业务限制 1. 广告报告数据有保留期限，业务查询需注意时间范围 2. 定时任务的状态管理需要监控 3. 警告规则的配置需要合理设置阈值 ### 7.3 扩展性考虑 1. 新增广告类型时需要扩展相应的表结构 2. 报告类型增加时需要更新配置表 3. 业务量增长时需要考虑分库分表策略 --- *文档版本: 1.0* \*最后更新: 2024-06-14\*