ik_yudao_device · 设备管理
MySQL 8.0.35。共 5 张表/视图、69 个字段、0 条物理外键。
保存设备日志文件、月活变化统计及规则导出配置/批次/结果。设备主档案仍在单体遗留库，设备大批量筛选另有ES检索数据。
表清单
使用状态：已接入 5 张。
| 表名 | 数据库表注释 | 字段数 | 使用状态 | 字段与索引 |
|---|---|---|---|---|
| device_log_file | 设备日志文件表 | 12 | 已接入 | 查看 |
| device_month_activity_stat | 月度活跃增减统计表 | 18 | 已接入 | 查看 |
| device_rule_export_batch | 规则引擎导出设备执行批次表 | 16 | 已接入 | 查看 |
| device_rule_export_config | 规则引擎导出设备配置表 | 10 | 已接入 | 查看 |
| device_rule_export_record | 规则引擎导出设备记录表 | 13 | 已接入 | 查看 |
数据库注释保留原文，可能包含历史业务名称；用途与数据来源另行说明。默认值 NULL 表示元数据未返回显式默认值，可空性以“可空”列 为准。未填写的注释不补造为数据库原注释。
device_log_file
BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_general_ci。
| 字段 | 类型 | 可空 | 默认值 | 数据库字段注释 | 附加属性 |
|---|---|---|---|---|---|
| id | bigint | 否 | NULL | 主键自增ID | auto_increment |
| mac | varchar(64) | 否 | NULL | 设备MAC地址 | — |
| cpuid | varchar(64) | 否 | （空） | 设备CPU ID | — |
| file_path | varchar(512) | 否 | NULL | 日志文件在文件服务器上的保存路径 | — |
| storage_path | varchar(512) | 是 | NULL | 文件在文件服务器上的相对存储路径（用于FileClient删除操作） | — |
| file_name | varchar(256) | 是 | NULL | 原始文件名 | — |
| file_size | bigint | 是 | 0 | 文件大小(字节) | — |
| tenant_id | bigint | 是 | NULL | 租户编号 | — |
| creator | varchar(64) | 是 | （空） | 创建者 | — |
| create_time | datetime | 否 | CURRENT_TIMESTAMP | 创建时间 | DEFAULT_GENERATED |
| updater | varchar(64) | 是 | （空） | 更新者 | — |
| update_time | datetime | 否 | CURRENT_TIMESTAMP | 更新时间 | DEFAULT_GENERATED on update CURRENT_TIMESTAMP |
索引（括号内数字为前缀长度，联合列严格按顺序列出）
| 索引名 | 性质 | 列顺序 | 方法 | 注释 |
|---|---|---|---|---|
| idx_create_time | 普通 | create_time | BTREE | — |
| idx_mac_cpuid_create_time | 普通 | mac, cpuid, create_time | BTREE | — |
| PRIMARY | 主键 | id, mac, cpuid | BTREE | — |
本表无物理外键。
业务与查询
使用情况：已接入。 设备上传日志后保存文件名、大小、访问地址和存储位置；MAC与CPU对应上传设备，正文保存在文件存储。管理端可按设备和时间查看及删除日志文件。
单设备日志查询使用 idx_mac_cpuid_create_time(mac,cpuid,create_time)，并限定时间；仅时间查询另有 idx_create_time(create_time)。
device_month_activity_stat
BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_0900_ai_ci。
| 字段 | 类型 | 可空 | 默认值 | 数据库字段注释 | 附加属性 |
|---|---|---|---|---|---|
| id | bigint | 否 | NULL | 主键，自增 | auto_increment |
| data_source | tinyint | 否 | NULL | 数据来源,0-UOTA,1-域名分发 | — |
| bench_month | varchar(6) | 否 | NULL | 基准月份，格式yyyyMM | — |
| bench_active_num | int | 否 | 0 | 基准月份活跃设备数 | — |
| bench_new_act_num | int | 否 | 0 | 基准月份新增激活数 | — |
| cmp_offset | tinyint | 否 | NULL | 对比偏移月(1=基准月份+1月) | — |
| cmp_month | varchar(6) | 否 | NULL | 对比月份，格式yyyyMM | — |
| cmp_active_num | int | 否 | 0 | 对比月份活跃设备数 | — |
| cmp_new_act_num | int | 否 | 0 | 对比月份新增激活数 | — |
| new_active_num | int | 否 | 0 | 对比月份新增活跃数 | — |
| bench_resurrect_num | int | 否 | 0 | 基于基准数据复活数量 | — |
| bench_loss_num | int | 否 | 0 | 基于基准数据流失数量 | — |
| loss_reactive_num | int | 否 | 0 | 流失后回归数量 | — |
| both_active_num | int | 否 | 0 | 两月均活跃数量 | — |
| new_act_both_active_num | int | 是 | 0 | 新激活留存数：在基准月份激活且在对比月份也活跃的设备数量 | — |
| cum_new_act_num | int | 否 | 0 | 累计新增激活数 | — |
| cum_loss_num | int | 否 | 0 | 累计流失数 | — |
| cum_new_active_num | int | 否 | 0 | 累计新增活跃量 | — |
索引（括号内数字为前缀长度，联合列严格按顺序列出）
| 索引名 | 性质 | 列顺序 | 方法 | 注释 |
|---|---|---|---|---|
| idx_data_source_bench_month | 普通 | data_source, bench_month | BTREE | — |
| PRIMARY | 主键 | id | BTREE | — |
本表无物理外键。
业务与查询
使用情况：已接入。 定期或人工触发统计后保存基准月与对比月的活跃、激活、留存和流失结果。查询与导出读取已生成记录，不会自动重算；先固定来源和月份再比较。
device_rule_export_batch
BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_unicode_ci。
| 字段 | 类型 | 可空 | 默认值 | 数据库字段注释 | 附加属性 |
|---|---|---|---|---|---|
| id | bigint | 否 | NULL | 主键(自增)，即执行批次ID | auto_increment |
| name | varchar(128) | 是 | NULL | 执行批次名称 | — |
| status | tinyint | 否 | 0 | 执行状态（0执行中 1停止 2异常 3完成） | — |
| start_time | datetime | 是 | NULL | 执行开始时间 | — |
| end_time | datetime | 是 | NULL | 执行完成时间 | — |
| log | text | 是 | NULL | 执行批次日志 | — |
| progress | double | 是 | 0 | 执行进度（0-100） | — |
| device_backup_url | varchar(512) | 是 | NULL | 设备备份文件地址 | — |
| total_device_count | bigint | 是 | 0 | 设备总数（本次扫描的设备总量） | — |
| matched_device_count | bigint | 是 | 0 | 匹配设备数（成功匹配到规则的设备数） | — |
| creator | varchar(64) | 是 | （空） | 创建者 | — |
| create_time | datetime | 否 | CURRENT_TIMESTAMP | 创建时间 | DEFAULT_GENERATED |
| updater | varchar(64) | 是 | （空） | 更新者 | — |
| update_time | datetime | 否 | CURRENT_TIMESTAMP | 更新时间 | DEFAULT_GENERATED on update CURRENT_TIMESTAMP |
| deleted | bit(1) | 否 | b'0' | 是否删除 | — |
| tenant_id | bigint | 否 | 0 | 租户编号 | — |
索引（括号内数字为前缀长度，联合列严格按顺序列出）
| 索引名 | 性质 | 列顺序 | 方法 | 注释 |
|---|---|---|---|---|
| idx_status | 普通 | status | BTREE | — |
| PRIMARY | 主键 | id | BTREE | — |
本表无物理外键。
业务与查询
使用情况：已接入。 启动设备规则导出后保存输入备份、执行状态、进度和过程日志。设备总数来自备份实际处理量，匹配数按各配置命中次数累计，跨配置不去重。
device_rule_export_config
BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_unicode_ci。
| 字段 | 类型 | 可空 | 默认值 | 数据库字段注释 | 附加属性 |
|---|---|---|---|---|---|
| id | bigint | 否 | NULL | 主键(自增) | auto_increment |
| name | varchar(128) | 否 | NULL | 配置名称 | — |
| remark | varchar(512) | 是 | NULL | 配置备注 | — |
| status | tinyint | 否 | 0 | 状态（0正常 1停用） | — |
| creator | varchar(64) | 是 | （空） | 创建者 | — |
| create_time | datetime | 否 | CURRENT_TIMESTAMP | 创建时间 | DEFAULT_GENERATED |
| updater | varchar(64) | 是 | （空） | 更新者 | — |
| update_time | datetime | 否 | CURRENT_TIMESTAMP | 更新时间 | DEFAULT_GENERATED on update CURRENT_TIMESTAMP |
| deleted | bit(1) | 否 | b'0' | 是否删除 | — |
| tenant_id | bigint | 否 | 0 | 租户编号 | — |
索引（括号内数字为前缀长度，联合列严格按顺序列出）
| 索引名 | 性质 | 列顺序 | 方法 | 注释 |
|---|---|---|---|---|
| PRIMARY | 主键 | id | BTREE | — |
本表无物理外键。
业务与查询
使用情况：已接入。 运营人员维护导出配置的名称、用途和启停状态，配置通过业务编号绑定独立规则。执行批次读取选中的配置，为每份配置分别匹配设备。
device_rule_export_record
BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_unicode_ci。
| 字段 | 类型 | 可空 | 默认值 | 数据库字段注释 | 附加属性 |
|---|---|---|---|---|---|
| id | bigint | 否 | NULL | 主键(自增) | auto_increment |
| batch_id | bigint | 否 | NULL | 执行批次ID，关联device_rule_export_batch.id | — |
| config_id | bigint | 否 | NULL | 导出配置ID，关联device_rule_export_config.id | — |
| config_name | varchar(128) | 是 | NULL | 配置名称（冗余，快照） | — |
| export_time | datetime | 是 | NULL | 导出时间（文件生成完成时间） | — |
| file_url | varchar(512) | 是 | NULL | 导出文件下载路径（文件服务器URL） | — |
| device_count | bigint | 是 | 0 | 本配置导出的设备数量 | — |
| creator | varchar(64) | 是 | （空） | 创建者 | — |
| create_time | datetime | 否 | CURRENT_TIMESTAMP | 创建时间 | DEFAULT_GENERATED |
| updater | varchar(64) | 是 | （空） | 更新者 | — |
| update_time | datetime | 否 | CURRENT_TIMESTAMP | 更新时间 | DEFAULT_GENERATED on update CURRENT_TIMESTAMP |
| deleted | bit(1) | 否 | b'0' | 是否删除 | — |
| tenant_id | bigint | 否 | 0 | 租户编号 | — |
索引（括号内数字为前缀长度，联合列严格按 顺序列出）
| 索引名 | 性质 | 列顺序 | 方法 | 注释 |
|---|---|---|---|---|
| idx_batch_id | 普通 | batch_id | BTREE | — |
| idx_config_id | 普通 | config_id | BTREE | — |
| PRIMARY | 主键 | id | BTREE | — |
本表无物理外键。
业务与查询
使用情况：已接入。 保存一个批次为一个配置生成的结果文件及行数，配置名称作为当时快照保留。按批次或配置查下载记录；批次未完成或异常时，没有文件不等于零命中。
config_id、batch_id 分别关联导出配置和批次，配置名称保留生成文件时的快照。
分区设计
| 表 | 分区数 | 方法 | 分区表达式 | 分区名与取值范围 |
|---|---|---|---|---|
| device_log_file | 32 | KEY | `mac`,`cpuid` | p0..p31；KEY 分区无显式 VALUES 边界 |
查询上述 KEY 分区表时，同时提供 mac 与 cpuid 的等值条件，便于按设备定位分区；仅按时间筛选不能据此裁剪分区。分区由 MySQL 内部计算，不使用 partition_index。详见分区规则。
本库查询要点
日志按 mac、cpuid、create_time 查 idx_mac_cpuid_create_time(mac,cpuid,create_time)，仅时间查询另有 idx_create_time(create_time)。KEY(mac,cpuid)32分区按设备分布；月活与导出应先定位来源、月份或批次，不把汇总结果当实时明细。