TDengine · 数据库、超级表与字段
版本 3.3.8.4。共 30 个数据库、31 个表结构、319 个字段与标签、4,651 个子表。子表继承超级表字段；不列逐设备子表名和标签值。
数据库与表清单
| 数据库 | 表 | 用途 | 子表数 | 字段与标签 |
|---|---|---|---|---|
| app_activity_day | app_activity_detail | 应用周期活跃 | 161 | 查看 |
| app_activity_month | app_activity_detail | 应用周期活跃 | 38 | 查看 |
| app_activity_year | app_activity_detail | 应用周期活跃 | 12 | 查看 |
| app_runtime_archive | flow_app_runtime | 应用运行明细 | 261 | 查看 |
| blacklisted | app_kill_record | 黑名单执行反馈 | 46 | 查看 |
| device_activity_day | device_activity_detail | 设备周期活跃 | 365 | 查看 |
| device_activity_day_uota2 | device_activity_detail | 设备周期活跃 | 80 | 查看 |
| device_activity_day_uota_new | device_activity_detail | 设备周期活跃 | 3 | 查看 |
| device_activity_day_uota_old | device_activity_detail | 设备周期活跃 | 27 | 查看 |
| device_activity_month | device_activity_detail | 设备周期活跃 | 39 | 查看 |
| device_activity_month_uota2 | device_activity_detail | 设备周期活跃 | 8 | 查看 |
| device_activity_month_uota_new | device_activity_detail | 设备周期活跃 | 1 | 查看 |
| device_activity_month_uota_old | device_activity_detail | 设备周期活跃 | 2 | 查看 |
| device_activity_year | device_activity_detail | 设备周期活跃 | 8 | 查看 |
| device_activity_year_uota2 | device_activity_detail | 设备周期活跃 | 3 | 查看 |
| device_activity_year_uota_new | device_activity_detail | 设备周期活跃 | 1 | 查看 |
| device_activity_year_uota_old | device_activity_detail | 设备周期活跃 | 1 | 查看 |
| device_runtime | device_runtime_detail | 设备运行区间 | 87 | 查看 |
| device_runtime | device_runtime | 设备运行区间 | 70 | 查看 |
| device_runtime_count_day | device_runtime_count | 设备运行统计 | 0 | 查看 |
| device_runtime_count_day_shadow | device_runtime_count | 设备运行统计 | 343 | 查看 |
| device_runtime_count_month | device_runtime_count | 设备运行统计 | 4 | 查看 |
| device_runtime_count_year | device_runtime_count | 设备运行统计 | 0 | 查看 |
| launcher_ad_play | launcher_ad_play_detail | 广告播放明细 | 74 | 查看 |
| launcher_ad_play_device_count_day | launcher_ad_play_device_count | 广告播放周期统计 | 307 | 查看 |
| launcher_ad_play_device_count_month | launcher_ad_play_device_count | 广告播放周期统计 | 76 | 查看 |
| launcher_ad_play_device_count_year | launcher_ad_play_device_count | 广告播放周期统计 | 58 | 查看 |
| launcher_exec | launcher_exec_record | 广告执行反馈 | 981 | 查看 |
| monitor | visit_minute | 访问监控 | 20 | 查看 |
| nebula_ids | flow_app_runtime | 应用运行明细 | 1567 | 查看 |
| server_monitor | server_monitor | 服务器监控 | 8 | 查看 |
每个表分别列出必填时间戳、普通字段和 TAG。TAG 描述子表所属设备、应用或周期；普通字段记录每次上报的数据。首列 TIMESTAMP 是时间主键，存在 data_key 复合主键列时，两列共同区分同一子表内的记录，data_key 仍属于普通字段，不是 TAG。详见 TDengine 超级表规则。
长度保留数据库定义值；编码、压缩和级别按列列出。tbname 是子表名称，不额外计入字段清单。子表数不是设备数、业务记录数或覆盖范围。时间的日期归一应与相应业务时区保持一致；同名的 record_time 在不同表中可能分别为时间列或 TAG。
app_activity_day
app_activity_detail
保存 SDK 应用的日活跃设备详情，包括版本、时长和 IP 地域信息。实时日志按接收日汇总、旧版直接上报和延迟补报均可产生记录；活跃记录与 APP 运行明细属于不同业务。
ts 表示日周期起点（当日零点）；日数据按上报路径取服务端当日、补报日期或日志汇总日期，月、年数据转换为对应周期起点。record_time TAG 取该日期的 yyyyMMdd 整数；package_name TAG 保留应用包名原值。
子表名为 aad_{包名中的点替换为下划线}_{record_time}，只有表名中的包名替换句点。data_key = MAC + CPU，直接拼接，无分隔符且保留 MAC 冒号；正常写入将空白 CPU 归为空串，MAC、CPU 仍分别保存在普通字段中。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 日周期起点（当日零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 设备组合键：MAC 与 CPU 直接拼接 | disabled / lz4 / medium |
| mac | VARCHAR | 32 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| version_code | INT | 4 | 数据列 | 应用版本号 | simple8b / lz4 / medium |
| duration | INT | 4 | 数据列 | 应用活跃时长（分钟） | simple8b / lz4 / medium |
| ip | VARCHAR | 64 | 数据列 | 上报 IP | disabled / lz4 / medium |
| country | VARCHAR | 64 | 数据列 | 上报 IP 解析出的国家 | disabled / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期日期，yyyyMMdd 整数 | disabled / disabled / disabled |
| package_name | VARCHAR | 255 | 标签 TAG | 应用包名原值 | disabled / disabled / disabled |
查询口径：按完整日周期限定 ts，同时指定 package_name 与 record_time。月首或年首早于查询起点时，该周期会被时间过滤排除。业务查询要求包名和日期范围，日窗口最多 30 天、月窗口最多 730 天、年窗口最多 3650 天；这些是业务限制。当前设备明细入口按周期 TAG 筛选，汇总入口同时使用 ts 范围，直接查询也应提供首时间列范围。
app_activity_month
app_activity_detail
保存 SDK 应用的月活跃设备详情，包括版本、时长和 IP 地域信息。实时日志按接收日汇总、旧版直接上报和延迟补报均可产生记录；活跃记录与 APP 运行明细属于不同业务。
ts 表示月周期起点（月首零点）；日数据按上报路径取服务端当日、补报日期或日志汇总日期，月、年数据转换为对应周期起点。record_time TAG 取该日期的 yyyyMM01 整数；package_name TAG 保留应用包名原值。
子表名为 aad_{包名中的点替换为下划线}_{record_time}，只有表名中的包名替换句点。data_key = MAC + CPU，直接拼接，无分隔符且保留 MAC 冒号；正常写入将空白 CPU 归为空串，MAC、CPU 仍分别保存在普通字段中。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 月周期起点（月首零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 设备组合键：MAC 与 CPU 直接拼接 | disabled / lz4 / medium |
| mac | VARCHAR | 32 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| version_code | INT | 4 | 数据列 | 应用版本号 | simple8b / lz4 / medium |
| duration | INT | 4 | 数据列 | 应用活跃时长（分钟） | simple8b / lz4 / medium |
| ip | VARCHAR | 64 | 数据列 | 上报 IP | disabled / lz4 / medium |
| country | VARCHAR | 64 | 数据列 | 上报 IP 解析出的国家 | disabled / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期日期，yyyyMM01 整数 | disabled / disabled / disabled |
| package_name | VARCHAR | 255 | 标签 TAG | 应用包名原值 | disabled / disabled / disabled |
查询口径：按完整月周期限定 ts，同时指定 package_name 与 record_time。月首或年首早于查询起点时，该周期会被时间过滤排除。业务查询要求包名和日期范围，日窗口最多 30 天、月窗口最多 730 天、年窗口最多 3650 天；这些是业务限制。当前设备明细入口按周期 TAG 筛选，汇总入口同时使用 ts 范围，直接查询也应提供首时间列范围。
app_activity_year
app_activity_detail
保存 SDK 应用的年活跃设备详情，包括版本、时长和 IP 地域信息。实时日志按接收日汇总、旧版直接上报和延迟补报均可产生记录；活跃记录与 APP 运行明细属于不同业务。
ts 表示年周期起点（年首零点）；日数据按上报路径取服务端当日、补报日期或日志汇总日期，月、年数据转换为对应周期起点。record_time TAG 取该日期的 yyyy0101 整数；package_name TAG 保留应用包名原值。
子表名为 aad_{包名中的点替换为下划线}_{record_time}，只有表名中的包名替换句点。data_key = MAC + CPU，直接拼接，无分隔符且保留 MAC 冒号；正常写入将空白 CPU 归为空串，MAC、CPU 仍分别保存在普通字段中。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 年周期起点（年首零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 设备组合键：MAC 与 CPU 直接拼接 | disabled / lz4 / medium |
| mac | VARCHAR | 32 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| version_code | INT | 4 | 数据列 | 应用版本号 | simple8b / lz4 / medium |
| duration | INT | 4 | 数据列 | 应用活跃时长（分钟） | simple8b / lz4 / medium |
| ip | VARCHAR | 64 | 数据列 | 上报 IP | disabled / lz4 / medium |
| country | VARCHAR | 64 | 数据列 | 上报 IP 解析出的国家 | disabled / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期日期，yyyy0101 整数 | disabled / disabled / disabled |
| package_name | VARCHAR | 255 | 标签 TAG | 应用包名原值 | disabled / disabled / disabled |
查询口径：按完整年周期限定 ts，同时指定 package_name 与 record_time。月首或年首早于查询起点时，该周期会被时间过滤排除。业务查询要求包名和日期范围，日窗口最多 30 天、月窗口最多 730 天、年窗口最多 3650 天；这些是业务限制。当前设备明细入口按周期 TAG 筛选，汇总入口同时使用 ts 范围，直接查询也应提供首时间列范围。
app_runtime_archive
flow_app_runtime
保存设备上报的应用运行时长、打开次数和应用版本。设备离线后补报仍按运行日期归属；运行日期与服务端接收时间需要分别使用。
record_time 为设备运行日期/时间，day TAG 取其日期部分的 yyyyMMdd 整数；业务按日上报，但不能把所有存量时间都视为强制零点。package_name TAG 保留包名原值。
子表名为 flow_app_runtime_{包名中的点替换为下划线}_{day}，不是每台设备一表。data_key = 去掉全部冒号的 MAC + '_' + CPU，保留大小写与其他字符；空字符串和缺失设备标识不可视为同一种有效设备身份。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | TIMESTAMP | 8 | 首时间列 | 设备上报的运行 日期/时间 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 300 | 复合主键列 | 去冒号 MAC、下划线、CPU 拼接的设备组合键 | disabled / zstd / medium |
| mac | VARCHAR | 20 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu_id | VARCHAR | 255 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| version_code | INT | 4 | 数据列 | 应用版本号 | simple8b / lz4 / high |
| duration | INT | 4 | 数据列 | 应用运行时长（分钟） | simple8b / lz4 / high |
| open_time | INT | 4 | 数据列 | 应用打开次数 | simple8b / lz4 / high |
| create_time | TIMESTAMP | 8 | 数据列 | 上报接收时间；缺失时使用消息处理时间 | delta-i / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 100 | 标签 TAG | 应用包名原值 | disabled / disabled / disabled |
| day | INT | 4 | 标签 TAG | 运行日期部分，yyyyMMdd 整数 | disabled / disabled / disabled |
查询口径：按 record_time 起止范围、package_name 和 day 查询，设备条件使用普通列 mac/cpu_id。当月和上月使用 TDengine nebula_ids，更早月份使用 app_runtime_archive；跨冷热边界需拆分请求。业务入口要求 MAC、CPU、包名至少提供一项，日期差不超过两个月。归档进度会影响历史数据完整性，查询路由本身不代表归档已完成。
blacklisted
app_kill_record
保存设备针对黑名单策略按日期上报的关闭应用次数。设备反馈经消息队列写入，frequency 保留该条上报值，写入服务不将它累加到已有次数；记录行数与次数合计是不同指标。
ts 必须来自可解析的上报 date，按 yyyy-MM-dd 转为服务端默认时区的日期零点；缺少可解析日期时不以当前时间补齐。create_time 则是处理本批消息的服务端时间。
唯一 TAG black_list_id 取上报的黑名单编号，逻辑关联 MySQL ik_apk.app_blacklisted.id；MySQL 编号为 BIGINT，本 TAG 为 INT，应注意值域差异。子表名为 app_kill_record_{blackListId}，每条策略一个子表。data_key = MAC + CPU，MAC 在前、CPU 在后，直接拼接，不去冒号、不加分隔符。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 设备上报的杀死日期（日期零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 1000 | 复合主键列 | MAC 与 CPU 按顺序直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 20 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu_id | VARCHAR | 255 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| frequency | INT | 4 | 数据列 | 本条上报的杀死次数 | simple8b / lz4 / medium |
| create_time | TIMESTAMP | 8 | 数据列 | 处理本批上报的服务端时间 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| black_list_id | INT | 4 | 标签 TAG | 上报的黑名单策略编号，逻辑关联 MySQL 主记录 | disabled / disabled / disabled |
查询口径：先限定 black_list_id 与 ts 日期范围，再按普通列 mac/cpu_id 查设备。create_time 用于接收时间窗口，不能代替杀死日期。后台异步导出必须选择 ts 范围，按天读取；列表数量统计是记录数，次数统计应使用 frequency。
device_activity_day
device_activity_detail
保存默认 UOTA（聚合新旧 UOTA）来源在日周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMMdd 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| ip | VARCHAR | 40 | 数据列 | 上报 IP | disabled / lz4 / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | delta-i / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选默认 UOTA（聚合新旧 UOTA）与日粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_day_uota2
device_activity_detail
保存域名分发来源在日周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMMdd 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选域名分发与日粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_day_uota_new
device_activity_detail
保存新 UOTA（新包名 com.soft.update）来源 在日周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMMdd 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划 线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选新 UOTA（新包名 com.soft.update）与日粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_day_uota_old
device_activity_detail
保存旧 UOTA（旧包名 com.android.netservice）来源在日周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMMdd 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选旧 UOTA（旧包名 com.android.netservice）与日粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id 。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_month
device_activity_detail
保存默认 UOTA（聚合新旧 UOTA）来源在月周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当月首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMM 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当月首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| ip | VARCHAR | 40 | 数据列 | 上报 IP | disabled / lz4 / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | delta-i / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期标签，yyyyMM 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选默认 UOTA（聚合新旧 UOTA）与月粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_month_uota2
device_activity_detail
保存域名分发来源在月周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当月首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMM 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当月首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期标签，yyyyMM 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选域名分发与月粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_month_uota_new
device_activity_detail
保存新 UOTA（新包名 com.soft.update）来源在月周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当月首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMM 整数，region_id 为本次活动归属地区编号，未提 供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当月首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期标签，yyyyMM 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选新 UOTA（新包名 com.soft.update）与月粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_month_uota_old
device_activity_detail
保存旧 UOTA（旧包名 com.android.netservice）来源在月周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并， 并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当月首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyyMM 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当月首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期标签，yyyyMM 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选旧 UOTA（旧包名 com.android.netservice）与月粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_year
device_activity_detail
保存默认 UOTA（聚合新旧 UOTA）来源在年周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当年首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyy 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当年首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| ip | VARCHAR | 40 | 数据列 | 上报 IP | disabled / lz4 / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | delta-i / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期标签，yyyy 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选默认 UOTA（聚合新旧 UOTA）与年粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_year_uota2
device_activity_detail
保存域名分发来源在年周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当年首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyy 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当年首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期标签，yyyy 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查 询口径：先选域名分发与年粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_year_uota_new
device_activity_detail
保存新 UOTA（新包名 com.soft.update）来源在年周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当年首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyy 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当年首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期标签，yyyy 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选新 UOTA（新包名 com.soft.update）与年粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_activity_year_uota_old
device_activity_detail
保存旧 UOTA（旧包名 com.android.netservice）来源在年周期内的设备活跃记录。相应设备活动进入系统后，按设备身份与周期归并，并保留设备档案、SDK 版本和 IP 地区信息。同一设备可出现在不同来源库中，跨来源行数不能直接相加当作去重设备数。
ts 归一为当年首日零点，输入时间缺失时使用服务端当前时间；日期归一按服务端默认时区。TAG record_time 为 yyyy 整数，region_id 为本次活动归属地区编号，未提供时初始为 -1，写入分支可按 IP 补充。
子表名为 {record_time}_{region_id}，没有超级表名前缀。data_key 先去掉 MAC 的全部冒号：CPU 为 null 时仅用该 MAC；CPU 非 null 时为 去冒号 MAC + '_' + CPU。空 CPU 字符串仍产生末尾下划线，不转大小写、不做哈希。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当年首日零点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 去冒号 MAC；非 null CPU 以一个下划线连接 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| ip | VARCHAR | 15 | 数据列 | 上报 IP | disabled / zstd / medium |
| device_id | BIGINT | 8 | 数据列 | 设备档案编号，逻辑关联 | simple8b / lz4 / medium |
| sdk_version | VARCHAR | 64 | 数据列 | 上报 SDK 版本 | disabled / zstd / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期标签，yyyy 整数 | disabled / disabled / disabled |
| region_id | INT | 4 | 标签 TAG | 活动归属地区编号；未提供时初始为 -1 | disabled / disabled / disabled |
查询口径：先选旧 UOTA（旧包名 com.android.netservice）与年粒度，再限定 ts 周期起点范围和 record_time；按地区分析可同时指定 region_id。MAC、CPU、设备编号是普通列，不是设备 TAG。月、年查询应包含所需周期的起点。
device_runtime
device_runtime_detail
保存设备上报的一段连续运行区间，开始和结束时间来自设备。只有结束晚于开始的区间进入运行统计，时长由毫秒差换算为秒；它不是周期活跃标记。
必填首时间列 start_time 为上报区间开始的 epoch 毫秒转换值，不按日归零；end_time 来自区间结束值。TAG mac/cpu 使用上报设备标识原值。
子表名为 MAC + '_' + CPU，不加超级表名前缀，不去冒号、不转大小写、不做哈希。本表没有 data_key 列，同一设备子表以内使用 start_time 区分记录。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| start_time | TIMESTAMP | 8 | 首时间列 | 设备运行区间开始时间 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| end_time | TIMESTAMP | 8 | 数据列 | 设备运行区间结束时间 | delta-i / lz4 / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| mac | VARCHAR | 17 | 标签 TAG | 设备 MAC | disabled / disabled / disabled |
| cpu | VARCHAR | 32 | 标签 TAG | 设备 CPU 标识 | disabled / disabled / disabled |
查询口径：先用 mac/cpu TAG 限定设备，并限制 start_time。按开始时间筛选表示“期间开始的区间”；如业务要统计“与期间重叠的所有区间”，还需使用开始、结束时间定义重叠条件，不能只把开始时间窗口当作完整覆盖。
device_runtime
保留包含设备身份、运行结束时间与时长的历史运行结构，与同库的 device_runtime_detail 是两个独立超级表。
首时间列为 ts，第二列 data_key 为复合主键列；普通列保留设备身份、结束时间和运行秒数。TAG record_time 为整数记录周期。历史子表命名、TAG 生成和设备键拼接规则无统一契约说明，应保留原值，不能套用 device_runtime_detail 或 device_runtime_count 的规则。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 历史运行记录时间 | delta-i / lz4 / medium |
普通字段（含复合 键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | 历史记录复合键，保留原值 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| end_time | TIMESTAMP | 8 | 数据列 | 设备运行区间结束时间 | delta-i / lz4 / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 历史记录周期标签，保留原值 | disabled / disabled / disabled |
查询口径：历史查询应先选择原子表或已有 record_time TAG，再限定 ts 范围。两张超级表的记录不宜直接合并为同一运行明细口径。
device_runtime_count_day
device_runtime_count
保存设备日周期的累计运行秒数。日写入按设备运行上报的 createTime 所属日期分组，合计正运行区间后换算为秒，并非按区间开始时间跨天拆段。
ts 使用当日零点；日归一采用服务端默认时区。TAG record_time 使用 yyyyMMdd 整数，写入时显式周期值优先，缺失时从 ts 格式化为 yyyyMMdd。
子表名为 device_runtime_count_{record_time}。data_key = MAC + CPU，直接拼接，无分隔符，保留冒号与大小写；与设备活跃库的设备键规则不同。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 日统计周期起点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与 CPU 直接拼接的设备组合键 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
查询口径：按日库的周期起点限定 ts，并使用 record_time TAG。MAC 和 CPU 为普通筛选列。月、年起点必须先对齐对应周期；主库和影子库只能按明确的业务口径选择，不做无条件并集。
device_runtime_count_day_shadow
device_runtime_count
保存设备日周期的累计运行秒数。日写入按设备运行上报的 createTime 所属日期分组，合计正运行区间后换算为秒，并非按区间开始时间跨天拆段。本库是日统计重整使用的影子存储，不能与主日库直接相加。
ts 使用当日零点；日归一采用服务端默认时区。TAG record_time 使用 yyyyMMdd 整数，写入时显式周期值优先，缺失时从 ts 格式化为 yyyyMMdd。
子表名为 device_runtime_count_{record_time}。data_key = MAC + CPU，直接拼接，无分隔符，保留冒号与大小写；与设备活跃库的设备键规则不同。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 日统计周期起点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与 CPU 直接拼接的设备组合键 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
查询口径：按日库的周期起点限定 ts，并使用 record_time TAG。MAC 和 CPU 为普通筛选列。月、年起点必须先对齐对应周期；主库和影子库只能按明确的业务口径选择，不做无条件并集。
device_runtime_count_month
device_runtime_count
保存设备月周期的累计运行秒数。日写入按设备运行上报的 createTime 所属日期分组，合计正运行区间后换算为秒，并非按区间开始时间跨天拆段。月、年库用于相应周期查询，不应将同一时长再与日库重复合计。
ts 使用月首零点；日归一采用服务端默认时区。TAG record_time 使用 yyyyMM01 整数，写入时显式周期值优先，缺失时从 ts 格式化为 yyyyMMdd。
子表名为 device_runtime_count_{record_time}。data_key = MAC + CPU，直接拼接，无分隔符，保留冒号与大小写；与设备活跃库的设备键规则不同。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 月统计周期起点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 月周期标签，yyyyMM01 整数 | disabled / disabled / disabled |
查询口径：按月库的周期起点限定 ts，并使用 record_time TAG。MAC 和 CPU 为普通筛选列。月、年起点必须先对齐对应周期；主库和影子库只能按明确的业务口径选择，不做无条件并集。
device_runtime_count_year
device_runtime_count
保存设备年周期的累计运行秒数。日写入按设备运行上报的 createTime 所属日期分组，合计正运行区间后换算为秒，并非按区间开始时间跨天拆段。月、年库用于相应周期查询，不应将同一时长再与日库重复合计。
ts 使用年首零点；日归一采用服务端默认时区。TAG record_time 使用 yyyy0101 整数，写入时显式周期值优先，缺失时从 ts 格式化为 yyyyMMdd。
子表名为 device_runtime_count_{record_time}。data_key = MAC + CPU，直接拼接，无分隔符，保留 冒号与大小写；与设备活跃库的设备键规则不同。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 年统计周期起点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| device_duration | INT | 4 | 数据列 | 设备运行时长（秒） | simple8b / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | INT | 4 | 标签 TAG | 年周期标签，yyyy0101 整数 | disabled / disabled / disabled |
查询口径：按年库的周期起点限定 ts，并使用 record_time TAG。MAC 和 CPU 为普通筛选列。月、年起点必须先对齐对应周期；主库和影子库只能按明确的业务口径选择，不做无条件并集。
launcher_ad_play
launcher_ad_play_detail
保存设备上报的单次广告播放或埋点明细，是否保留受明细开关及实时上报路径控制。广告位置也可代表三方请求、跳转和应用打开等事件，不能把每条记录都视为播放成功。
必填 begin_time 表示播放或埋点开始时间。旧回调采用设备开始、结束时间；V2 缺省时间优先使用与服务端当前时间相差不足一小时的请求时间，否则使用当前时间。V2 实时保存还按该时间点北京与德国时差调整开始时间，end_time = begin_time + play_duration × 1000 毫秒，不能把此时区规则套用于所有历史记录。
TAG package_name/version_code/ad_index_id 分别取上报包名、应用版本和广告位置；time_tag 取最终 begin_time 的 yyyyMMdd 整数。ad_play_type 为 0/空时表示默认分类，1 表示三方德国时区分类；当前实时保存路径写入 1。
partition_index = abs(Java String.hashCode(MAC + CPU) % 150) + 1，空白 CPU 先归为空串，取值 1—150；按 UTF-16 代码单元执行 Java 32 位有符号哈希，先取余、再绝对值、最后加一。它是 TAG 分桶，不是 MySQL 分区。
子表名为 {包名点转下划线}_{version_code}_{ad_index_id}_{partition_index}[_{非零ad_play_type}]_{time_tag}，没有超级表名前缀，默认分类不拼接类型段。data_key = MAC + CPU，直接拼接，无分隔符、不去冒号、不做哈希。正常写入将空白 CPU 归为空串，非空 CPU 保留原值；不同上报入口的 MAC 预处理不同，不能对历史设备键统一改写大小写。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| begin_time | TIMESTAMP | 8 | 首时间列 | 播放或埋点开始时间；实时路径可有时区调整 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与归一 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| end_time | TIMESTAMP | 8 | 数据列 | 播放或埋点结束时间 | delta-i / lz4 / medium |
| play_duration | INT | 4 | 数据列 | 本次区间时长（秒） | simple8b / lz4 / high |
| log_info | VARCHAR | 1024 | 数据列 | 设备调试说明；实时路径可为空 | disabled / lz4 / medium |
| create_time | TIMESTAMP | 8 | 数据列 | 服务端接收后创建记录的时间 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 128 | 标签 TAG | 上报应用包名原值 | disabled / disabled / disabled |
| version_code | BIGINT | 8 | 标签 TAG | 上报应用版本号 | disabled / disabled / disabled |
| ad_index_id | INT | 4 | 标签 TAG | 上报广告位置或埋点编号 | disabled / disabled / disabled |
| time_tag | INT | 4 | 标签 TAG | 最终开始时间所属日，yyyyMMdd 整数 | disabled / disabled / disabled |
| partition_index | INT | 4 | 标签 TAG | 设备哈希分桶，1—150 | disabled / disabled / disabled |
| ad_play_type | INT | 4 | 标签 TAG | 默认分类 0/空；三方德国时区分类 1 | disabled / disabled / disabled |
查询口径：按 begin_time 起止范围、time_tag、包名和广告位置限定记录，并按需要增加版本、分类和分桶。单设备查询可按相同规则计算分桶，同时使用 MAC、CPU 普通列过滤；只限定分桶仍包含其他设备。按接收时间排查时使用 create_time，它与播放日期不同。
launcher_ad_play_device_count_day
launcher_ad_play_device_count
保存每台设备在日周期、指定应用版本及广告位置上的次数与累计秒数。数据来自设备周期上报、旧播放回调归组或播放明细归并。播放或埋点次数不等于去重设备数，汇总结果也不保证均有完整明细可回溯。
必填 record_time 为当日零点；time_tag TAG 为 yyyyMMdd 整数，月、年周期由汇总任务明确写入。其余 TAG package_name/version_code/ad_index_id/ad_play_type 沿用来源数据的应用包名、版本、广告位置和分类，0/空为默认分类，1 为三方德国时区分类。
子表名为 launcher_ad_play_device_count_{包名点转下划线}_{version_code}_{ad_index_id}[_{非零ad_play_type}]_{time_tag}；默认分类省略类型段，没有分桶段，也不是每台设备一个子表。data_key = MAC + CPU，直接拼接，无分隔符、不去冒号、不做哈希。正常写入将空白 CPU 归为空串，非空 CPU 保留原值；不同上报入口的 MAC 预处理不同，不能对历史设备键统一改写大小写。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | TIMESTAMP | 8 | 首时间列 | 日统计周期起点（当日零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与归一 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| play_duration | INT | 4 | 数据列 | 该设备该周期累计时长（秒） | simple8b / lz4 / high |
| play_count | INT | 4 | 数据列 | 该设备该周期播放或埋点次数 | simple8b / lz4 / high |
| create_time | TIMESTAMP | 8 | 数据列 | 周期结果生成时间，不是最早播放时间 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 128 | 标签 TAG | 来源数据的应用包名原值 | disabled / disabled / disabled |
| version_code | BIGINT | 8 | 标签 TAG | 来源数据的应用版本号 | disabled / disabled / disabled |
| ad_index_id | INT | 4 | 标签 TAG | 广告位置或埋点编号 | disabled / disabled / disabled |
| time_tag | INT | 4 | 标签 TAG | 日周期标签，yyyyMMdd 整数 | disabled / disabled / disabled |
| ad_play_type | INT | 4 | 标签 TAG | 默认分类 0/空；三方德国时区分类 1 | disabled / disabled / disabled |
查询口径：先限定 record_time 的完整日周期起点范围和 time_tag，再按包名、版本、广告位置及分类筛选。设备条件为普通列 MAC、CPU；跨粒度统计选择一个目标粒度，不把日、月、年结果叠加。
launcher_ad_play_device_count_month
launcher_ad_play_device_count
保存每台设备在月周期、指定应用版本及广告位置上的次数与累计秒数。数据由日统计按设备、包名、版本、位置和分类汇总。播放或埋点次数不等于去重设备数，汇总结果也不保证均有完整明细可回溯。
必填 record_time 为月首零点；time_tag TAG 为 yyyyMM 整数，月、年周期由汇总任务明确写入。其余 TAG package_name/version_code/ad_index_id/ad_play_type 沿用来源数据的应用包名、版本、广告位置和分类，0/空为默认分类，1 为三方德国时区分类。
子表名为 launcher_ad_play_device_count_{包名点转下划线}_{version_code}_{ad_index_id}[_{非零ad_play_type}]_{time_tag}；默认分类省略类型段，没有分桶段，也不是每台设备一个子表。data_key = MAC + CPU，直接拼接，无分隔符、不去冒号、不做哈希。正常写入将空白 CPU 归为空串，非空 CPU 保留原值；不同上报入口的 MAC 预处理不同，不能对历史设备键统一改写大小写。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | TIMESTAMP | 8 | 首时间列 | 月统计周期起点（月首零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与归一 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| play_duration | INT | 4 | 数据列 | 该设备该周期累计时长（秒） | simple8b / lz4 / high |
| play_count | INT | 4 | 数据列 | 该设备该周期播放或埋点次数 | simple8b / lz4 / high |
| create_time | TIMESTAMP | 8 | 数据列 | 周期结果生成时间，不是最早播放时间 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 128 | 标签 TAG | 来源数据的应用包名原值 | disabled / disabled / disabled |
| ad_index_id | INT | 4 | 标签 TAG | 广告位置或埋点编号 | disabled / disabled / disabled |
| time_tag | INT | 4 | 标签 TAG | 月周期标签，yyyyMM 整数 | disabled / disabled / disabled |
| version_code | BIGINT | 8 | 标签 TAG | 来源数据的应用版本号 | disabled / disabled / disabled |
| ad_play_type | INT | 4 | 标签 TAG | 默认分类 0/空；三方德国时区分类 1 | disabled / disabled / disabled |
查询口径：先限定 record_time 的完整月周期起点范围和 time_tag，再按包名、版本、广告位置及分类筛选。设备条件为普通列 MAC、CPU；跨粒度统计选择一个目标粒度，不把日、月、年结果叠加。
launcher_ad_play_device_count_year
launcher_ad_play_device_count
保存每台设备在年周期、指定应用版本及广告位置上的次数与累计秒数。数据由月统计按设备、包名、版本、位置和分类汇总。播放或埋点次数不等于去重设备数，汇总结果也不保证均有完整明细可回溯。
必填 record_time 为年首零点；time_tag TAG 为 yyyy 整数，月、年周期由汇总任务明确写入。其余 TAG package_name/version_code/ad_index_id/ad_play_type 沿用来源数据的应用包名、版本、广告位置和分类，0/空为默认分类，1 为三方德国时区分类。
子表名为 launcher_ad_play_device_count_{包名点转下划线}_{version_code}_{ad_index_id}[_{非零ad_play_type}]_{time_tag}；默认分类省略类型段，没有分桶段，也不是每台设备一个子表。data_key = MAC + CPU，直接拼接，无分隔符、不去冒号、不做哈希。正常写入将空白 CPU 归为空串，非空 CPU 保留原值；不同上报入口的 MAC 预处理不同，不能对历史设备键统一改写大小写。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | TIMESTAMP | 8 | 首时间列 | 年统计周期起点（年首零点） | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与归一 CPU 直接拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / lz4 / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / lz4 / medium |
| play_duration | INT | 4 | 数据列 | 该设备该周期累计时长（秒） | simple8b / lz4 / high |
| play_count | INT | 4 | 数据列 | 该设备该周期播放或埋点次数 | simple8b / lz4 / high |
| create_time | TIMESTAMP | 8 | 数据列 | 周期结果生成时间，不是最早播放时间 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 128 | 标签 TAG | 来源数据的应用包名原值 | disabled / disabled / disabled |
| ad_index_id | INT | 4 | 标签 TAG | 广告位置或埋点编号 | disabled / disabled / disabled |
| time_tag | INT | 4 | 标签 TAG | 年周期标签，yyyy 整数 | disabled / disabled / disabled |
| version_code | BIGINT | 8 | 标签 TAG | 来源数据的应用版本号 | disabled / disabled / disabled |
| ad_play_type | INT | 4 | 标签 TAG | 默认分类 0/空；三方德国时区分类 1 | disabled / disabled / disabled |
查询口径：先限定 record_time 的完整年周期起点范围和 time_tag，再按包名、版本、广告位置及分类筛选。设备条件为普通列 MAC、CPU；跨粒度统计选择一个目标粒度，不把日、月、年结果叠加。
launcher_exec
launcher_exec_record
保存设备完成广告素材下载、应用安装或检查到应用已存在后的反馈。素材配置编号和反馈类型共同确定子表；尚未反馈不能直接判定配置无效。
必填 ts 表示执行时间，设备已提供时保留。缺失时，若请求 d_time 与服务器当前时间相差不足 60 秒，则采用 d_time，否则使用当前服务端时间；不按日归零。d_time 表示设备调用接口的时间，可由请求头补充，create_time 表示后台处理消息的时间。
TAG ad_resource_id 对应 launcher_index_advert.id，不是文件编号或广告位置号；TAG type 为 0 图片下载完成、1 视频下载完成、2 APP 安装完成、3 APP 已存在。子表名为 ler_{ad_resource_id}_{type}，无日期或设备段。data_key = MAC + CPU，直接拼接，无分隔符、不去冒号、不做哈希。正常写入将空白 CPU 归为空串，非空 CPU 保留原值；不同上报入口的 MAC 预处理不同，不能对历史设备键统一改写大小写。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 执行时间；缺失时由请求时间或服务端时间补齐 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 64 | 复合主键列 | MAC 与归一 CPU 直接拼接的设备组合键 | disabled / zstd / medium |
| mac | VARCHAR | 17 | 数据列 | 设备 MAC | disabled / zstd / medium |
| cpu | VARCHAR | 32 | 数据列 | 设备 CPU 标识 | disabled / zstd / medium |
| create_time | TIMESTAMP | 8 | 数据列 | 后台消息处理时间 | delta-i / lz4 / medium |
| d_time | TIMESTAMP | 8 | 数据列 | 设备调用接口的时间，可由请求头补充 | delta-i / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ad_resource_id | BIGINT | 8 | 标签 TAG | 广告位素材配置编号，逻辑关联 launcher_index_advert.id | disabled / disabled / disabled |
| type | INT | 4 | 标签 TAG | 0 图片下载；1 视频下载；2 APP 安装；3 APP 已存在 | disabled / disabled / disabled |
查询口径：按 ad_resource_id/type TAG 与 ts 执行时间范围查询，再按 MAC、CPU 筛选设备。设备上报时间 和服务端接收时间分别使用 d_time/create_time，不能混用为执行完成时间。
monitor
visit_minute
保存按分钟汇总的接口访问、成功与失败次数，结合路径、服务节点、域名和端口区分访问来源。
ts 为访问分钟的起点，秒和毫秒归零；month TAG 为该时间的 yyyyMM 整数，url_alias TAG 来自路径监控配置。普通字段 url 保存日志的原始请求路径。
子表名按 visit_minute + ('_' + url).replace('.', '_') + '_' + month + '_v2' 生成，仅替换路径中的点，保留斜杠；不是按别名生成。data_key = server_ip + '_' + domain + '_' + port，用下划线连接服务器 IP、域名和端口。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 分钟统计起点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 300 | 复合主键列 | 服务器 IP、域名、端口以各一个下划线连接 | disabled / lz4 / medium |
| url | VARCHAR | 200 | 数据列 | 日志原始请求路径 | disabled / lz4 / medium |
| server_ip | VARCHAR | 20 | 数据列 | 服务器IP | disabled / lz4 / medium |
| domain | VARCHAR | 255 | 数据列 | 访问域名 | disabled / lz4 / medium |
| visit_count | INT | 4 | 数据列 | 访问次数 | simple8b / lz4 / medium |
| sucess_count | INT | 4 | 数据列 | 成功次数，字段保留原拼写 | simple8b / lz4 / medium |
| fail_count | INT | 4 | 数据列 | 失败次数 | simple8b / lz4 / medium |
| create_time | TIMESTAMP | 8 | 数据列 | 分钟汇总记录的创建时间 | delta-i / lz4 / medium |
| port | INT | 4 | 数据列 | 服务端口 | simple8b / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| url_alias | VARCHAR | 200 | 标签 TAG | 配置的访问路径别名 | disabled / disabled / disabled |
| month | INT | 4 | 标签 TAG | 统计月份，yyyyMM 整数 | disabled / disabled / disabled |
查询口径：按 ts 分钟范围与 month TAG 限定时间，再按 url_alias 或请求路径选择接口，必要时增加服务节点、域名和端口条件。分钟计数与请求逐条明细不同，不要将一个分钟统计行解释为一次请求。
nebula_ids
flow_app_runtime
保存设备上报的应用运行时长、打开次数和应用版本。设备离线后补报仍按运行日期归属；运行日期与服务端接收时间需要分别使用。
record_time 为设备运行日期/时间，day TAG 取其日期部分的 yyyyMMdd 整数；业务按日上报，但不能把所有存量时间都视为强制零点。package_name TAG 保留包名原值。
子表名为 flow_app_runtime_{包名中的点替换为下划线}_{day}，不是每台设备一表。data_key = 去掉全部冒号的 MAC + '_' + CPU，保留大小写与其他字符；空字符串和缺失设备标识不可视为同一种有效设备身份。
必填时间戳
| 字段 | 类型 | 长度 | 列角 色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| record_time | TIMESTAMP | 8 | 首时间列 | 设备上报的运行日期/时间 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| data_key | VARCHAR | 300 | 复合主键列 | 去冒号 MAC、下划线、CPU 拼接的设备组合键 | disabled / lz4 / medium |
| mac | VARCHAR | 20 | 数据列 | 设备 MAC | disabled / lz4 / high |
| cpu_id | VARCHAR | 255 | 数据列 | 设备 CPU 标识 | disabled / lz4 / high |
| version_code | INT | 4 | 数据列 | 应用版本号 | simple8b / lz4 / high |
| duration | INT | 4 | 数据列 | 应用运行时长（分钟） | simple8b / lz4 / high |
| open_time | INT | 4 | 数据列 | 应用打开次数 | simple8b / lz4 / high |
| create_time | TIMESTAMP | 8 | 数据列 | 上报接收时间；缺失时使用消息处理时间 | delta-i / lz4 / high |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| package_name | VARCHAR | 100 | 标签 TAG | 应用包名原值 | disabled / disabled / disabled |
| day | INT | 4 | 标签 TAG | 运行日期部分，yyyyMMdd 整数 | disabled / disabled / disabled |
查询口径：按 record_time 起止范围、package_name 和 day 查询，设备条件使用普通列 mac/cpu_id。当月和上月使用 TDengine nebula_ids，更早月份使用 app_runtime_archive；跨冷热边界需拆分请求。业务入口要求 MAC、CPU、包名至少提供一项，日期差不超过两个月。归档进度会影响历史数据完整性，查询路由本身不代表归档已完成。
server_monitor
server_monitor
保存服务器负载、CPU、内存、网络、磁盘、进程及 Nginx 指标，用于查看指定服务器随时间变化的运行状态。监控查询入口保留，自动采集调度处于停用状态。
必填 ts 为当前毫秒时间按 5 秒向下对齐后的时间点。TAG server_name 取监控配置的服务器名称，子表名直接使用该名称，无额外前缀或日期后缀。本表没有 data_key，同一服务器子表使用 ts 区分记录。
必填时间戳
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| ts | TIMESTAMP | 8 | 首时间列 | 当前时间向下对齐至 5 秒的监控时间点 | delta-i / lz4 / medium |
普通字段（含复合键）
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| load_one | DOUBLE | 8 | 数据列 | 1分钟负载 | bss / lz4 / medium |
| load_five | DOUBLE | 8 | 数据列 | 5分钟负载 | bss / lz4 / medium |
| load_fifteen | DOUBLE | 8 | 数据列 | 15分钟负载 | bss / lz4 / medium |
| load_max | INT | 4 | 数据列 | 最大负载阈值 | simple8b / lz4 / medium |
| load_limit | INT | 4 | 数据列 | 负载限制 | simple8b / lz4 / medium |
| load_safe | DOUBLE | 8 | 数据列 | 安全负载值 | bss / lz4 / medium |
| cpu_percent | DOUBLE | 8 | 数据列 | CPU 使用率（%） | bss / lz4 / medium |
| cpu_cores | INT | 4 | 数据列 | CPU核心数 | simple8b / lz4 / medium |
| cpu_model | VARCHAR | 200 | 数据列 | CPU型号 | disabled / zstd / medium |
| cpu_user | DOUBLE | 8 | 数据列 | CPU 用户态使用率（%） | bss / lz4 / medium |
| cpu_nice | DOUBLE | 8 | 数据列 | CPU nice 使用率（%） | bss / lz4 / medium |
| cpu_system | DOUBLE | 8 | 数据列 | CPU 系统态使用率（%） | bss / lz4 / medium |
| cpu_idle | DOUBLE | 8 | 数据列 | CPU 空闲率（%） | bss / lz4 / medium |
| cpu_iowait | DOUBLE | 8 | 数据列 | CPU I/O 等待率（%） | bss / lz4 / medium |
| cpu_irq | DOUBLE | 8 | 数据列 | CPU 硬中断率（%） | bss / lz4 / medium |
| cpu_softirq | DOUBLE | 8 | 数据列 | CPU 软中断率（%） | bss / lz4 / medium |
| cpu_steal | DOUBLE | 8 | 数据列 | CPU steal 比例（%） | bss / lz4 / medium |
| process_total | INT | 4 | 数据列 | 总进程数 | simple8b / lz4 / medium |
| process_active | INT | 4 | 数据列 | 活跃进程数 | simple8b / lz4 / medium |
| mem_total | BIGINT | 8 | 数据列 | 总内存（MB） | simple8b / lz4 / medium |
| mem_free | BIGINT | 8 | 数据列 | 空闲内存（MB） | simple8b / lz4 / medium |
| mem_buffers | BIGINT | 8 | 数据列 | 缓冲区内存（MB） | simple8b / lz4 / medium |
| mem_cached | BIGINT | 8 | 数据列 | 缓存内存（MB） | simple8b / lz4 / medium |
| mem_available | BIGINT | 8 | 数据列 | 可用内存（MB） | simple8b / lz4 / medium |
| mem_shared | BIGINT | 8 | 数据列 | 共享内存（MB） | simple8b / lz4 / medium |
| mem_real_used | BIGINT | 8 | 数据列 | 实际使用内存（MB） | simple8b / lz4 / medium |
| net_up_total | BIGINT | 8 | 数据列 | 上行累计流量（KB） | simple8b / lz4 / medium |
| net_down_total | BIGINT | 8 | 数据列 | 下行累计流量（KB） | simple8b / lz4 / medium |
| net_up_packets | BIGINT | 8 | 数据列 | 上行累计包数 | simple8b / lz4 / medium |
| net_down_packets | BIGINT | 8 | 数据列 | 下行累计包数 | simple8b / lz4 / medium |
| network_detail | VARCHAR | 6000 | 数据列 | 各网卡网络指标明细（JSON） | disabled / zstd / medium |
| disk_detail | VARCHAR | 6000 | 数据列 | 磁盘分区明细（JSON） | disabled / zstd / medium |
| iostat_detail | VARCHAR | 6000 | 数据列 | 磁盘 I/O 指标明细（JSON） | disabled / zstd / medium |
| system_os | VARCHAR | 200 | 数据列 | 操作系统 | disabled / zstd / medium |
| uptime | VARCHAR | 50 | 数据列 | 持续运行时间文本 | disabled / zstd / medium |
| bt_version | VARCHAR | 20 | 数据列 | 宝塔版本 | disabled / zstd / medium |
| site_total | INT | 4 | 数据列 | 网站总数 | simple8b / lz4 / medium |
| ftp_total | INT | 4 | 数据列 | FTP 总数 | simple8b / lz4 / medium |
| database_total | INT | 4 | 数据列 | 数据库总数 | simple8b / lz4 / medium |
| nginx_active | INT | 4 | 数据列 | Nginx 活跃连接数 | simple8b / lz4 / medium |
| nginx_accepts | BIGINT | 8 | 数据列 | Nginx 累计接受连接数 | simple8b / lz4 / medium |
| nginx_handled | BIGINT | 8 | 数据列 | Nginx 累计处理连接数 | simple8b / lz4 / medium |
| nginx_requests | BIGINT | 8 | 数据列 | Nginx 累计请求数 | simple8b / lz4 / medium |
| nginx_reading | INT | 4 | 数据列 | Nginx 正在读取的连接数 | simple8b / lz4 / medium |
| nginx_writing | INT | 4 | 数据列 | Nginx 正在写入的连接数 | simple8b / lz4 / medium |
| nginx_waiting | INT | 4 | 数据列 | Nginx 等待连接数 | simple8b / lz4 / medium |
TAG 标签
| 字段 | 类型 | 长度 | 列角色 | 业务释义 | 编码 / 压缩 / 级别 |
|---|---|---|---|---|---|
| server_name | VARCHAR | 63 | 标签 TAG | 监控配置中的服务器名称 | disabled / disabled / disabled |
查询口径：按 server_name TAG 与明确的 ts 起止范围查询；趋势可按所需时间粒度聚合。网络流量、包数和 Nginx 接受连接数等累计量不同于区间增量，不能直接求和作为该时段新增量。
查询边界
每次查询先限定首时间列范围，再结合表中实际存在的 TAG 缩小子表范围。设备标识属于普通字段时，不能当作设 备 TAG；LIMIT 只限制返回量，不能代替时间与标签条件。冷热分库及业务窗口见查询与性能。