ik_yudao_launcher · 桌面与广告

MySQL 8.0.35。共 8 张表/视图、76 个字段、0 条物理外键。

保存Launcher版本基础信息、广告位、广告位素材和投放关系。管理员维护配置，审批控制变更生效；播放与执行结果来自设备反馈，不能由配置数量推算。

表清单

使用状态：已接入 5 张、历史兼容 3 张。

表名	数据库表注释	字段数	使用状态	字段与索引
launcher_ad_play_count	launcher广告播放统计	14	已接入	查看
launcher_advert_push_task	launcher广告位资源与任务推送关系表	3	已接入	查看
launcher_base_info	launcher基本信息表	15	已接入	查看
launcher_index	launcher广告位	15	已接入	查看
launcher_index_advert	广告位与广告关联	17	已接入	查看
launcher_index_chanel	广告位与渠道关联	4	历史兼容	查看
launcher_index_mac	广告位与NAC关联	4	历史兼容	查看
launcher_index_region	广告位与国家关联	4	历史兼容	查看

数据库注释保留原文，可能包含历史业务名称；用途与数据来源另行说明。默认值 NULL 表示元数据未返回显式默认值，可空性以“可空”列为准。未填写的注释不补造为数据库原注释。

launcher_ad_play_count

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_unicode_ci。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	int	否	NULL	主键(自增)	auto_increment
type	int	是	NULL	类型，0-日，1-月，2-年	—
ad_play_type	int	是	NULL	0-默认分类，1-三方(德国时区客户)。具体见数据字典launcher_ad_play_type	—
package_name	varchar(255)	是	NULL	launcher包名	—
ad_index_id	int	是	NULL	广告位索引;0-13	—
play_count	int	是	NULL	播放次数	—
play_duration	bigint	是	NULL	播放时长	—
record_time	datetime	是	NULL	记录时间	—
version_code	bigint	是	-99999	默认值勿动，-99999	—
creator	varchar(64)	是	NULL	创建者	—
create_time	datetime	否	CURRENT_TIMESTAMP	创建时间	DEFAULT_GENERATED
updater	varchar(64)	是	NULL	更新者	—
update_time	datetime	否	CURRENT_TIMESTAMP	更新时间	DEFAULT_GENERATED
deleted	bit(1)	否	b'0'	是否删除	—

字段补充属性：

字段	排序规则	生成表达式
creator	utf8mb4_zh_0900_as_cs	—
updater	utf8mb4_zh_0900_as_cs	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
keys	唯一	type, package_name, ad_index_id, record_time, version_code, ad_play_type	BTREE	—
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：已接入。 保存广告位置、包名、版本和分类的周期汇总。当前汇总任务先将TD日统计写入MySQL日结果，再由MySQL日结果生成月结果、月结果生成年结果；不是每次展示都扫描播放明细。

先限定周期和分类，播放次数不是去重设备数，广告位置统计也不等于某一素材播放量。

launcher_advert_push_task

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键	auto_increment
advert_id	bigint	是	NULL	广告资源ID	—
push_task_id	bigint	是	NULL	任务推送ID	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
key_index	唯一	advert_id, push_task_id	BTREE	—
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：已接入。 保存广告素材配置与推送任务的绑定，由绑定任务操作维护。执行反馈通过素材关联到任务，安装完成的成功统计按MAC去重，绑定数量不是安装成功数量。

launcher_base_info

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	int	否	NULL	主键	auto_increment
name	varchar(100)	是	NULL	名称	—
package_name	varchar(100)	是	NULL	包名	—
remarks	varchar(100)	是	NULL	备注	—
version_code	varchar(8192)	是	NULL	launcher版本号,多个用英文逗号隔开	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—
draft	json	是	NULL	未审批通过的草稿数据	—
bpm_status	tinyint	是	NULL	流程状态,-1-未开始(草稿)，1-审批中，2-审批通过，3-审批不通过，4-已取消	—
process_instance_id	varchar(255)	是	NULL	流程实例ID	—
creator	varchar(64)	是	NULL	创建者	—
create_time	datetime	否	CURRENT_TIMESTAMP	创建时间	DEFAULT_GENERATED
updater	varchar(64)	是	NULL	更新者	—
update_time	datetime	否	CURRENT_TIMESTAMP	更新时间	DEFAULT_GENERATED
deleted	bit(1)	否	b'0'	是否删除	—
tenant_id	bigint	否	0	租户编号	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：已接入。 保存Launcher名称、包名、版本范围及审批状态。管理员新增、修改和审批后形成生效配置，设备按包名版本查询；审批草稿不等于正式投放配置。

按包名、版本和生效状态查询；同包名可有多套配置。

launcher_index

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键，自增长	auto_increment
index	int	是	NULL	广告位索引;0-11共12个	—
base_info_id	bigint	是	NULL	launcher主表ID	—
version	bigint	是	NULL	广告位版本号;取当前时间戳	—
enable	tinyint(1)	是	NULL	是否开启;1-是，0-否	—
group	varchar(255)	是	NULL	每个组下的广告位只能有一个,即baseInfoId+index+group确定一条数据	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—
draft	json	是	NULL	未审批通过的草稿数据	—
remarks	varchar(100)	是	NULL	备注	—
creator	varchar(64)	是	NULL	创建者	—
create_time	datetime	否	CURRENT_TIMESTAMP	创建时间	DEFAULT_GENERATED
updater	varchar(64)	是	NULL	更新者	—
update_time	datetime	否	CURRENT_TIMESTAMP	更新时间	DEFAULT_GENERATED
deleted	bit(1)	否	b'0'	是否删除	—
tenant_id	bigint	否	0	租户编号	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：已接入。 保存一级Launcher配置下的广告位置、启用状态和版本，新增配置和广告位维护形成记录。投放还受生效状态、可用素材及设备范围限制，配置存在不代表设备已经执行。

base_info_id 关联一级配置；广告位记录编号、位置编号和配置版本不能互换。

launcher_index_advert

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键，自增长	auto_increment
index_id	bigint	是	NULL	广告位索引ID;0-11共12个	—
type	int	是	NULL	广告类型;定义见属性表property=launcherTaskAdvertType。0-视频，1-图片，2-网页，3-其它	—
url	varchar(512)	是	NULL	广告链接地址;由resource_id带出	—
size	int	是	NULL	广告资源大小(字节);由resource_id带出	—
app_url	varchar(255)	是	NULL	app下载地址;由app_id带出	—
app_size	int	是	NULL	APP大小;由app_id带出	—
app_package_name	varchar(255)	是	NULL	APP包名;由app_id带出	—
app_version_code	int	是	NULL	APP版本号;由app_id带出	—
app_version_name	varchar(255)	是	NULL	APP版本名称;由app_id带出	—
enable	tinyint(1)	是	NULL	是否开启;1-是，0-否	—
app_id	bigint	是	NULL	APP关联文件;文件表ID	—
resource_id	bigint	是	NULL	资源文件关联文件;文件表ID	—
info	varchar(512)	是	NULL	字幕其它信息	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—
remark	varchar(1024)	是	NULL	备注	—
draft	json	是	NULL	未审批通过的草稿数据	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：已接入。 保存广告位的图片、视频、字幕及关联APK配置，由素材维护、审批和启停操作产生。素材编号逻辑连接文件资料，同一广告位生效启用资源遵循互斥规则，执行结果单独由设备反馈。

素材配置编号不同于文件编号；查询时结合审批状态及文件可用性。

launcher_index_chanel

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键，自增长	auto_increment
index_id	bigint	是	NULL	广告位索引ID;0-11共12个	—
chanel_id	bigint	是	NULL	渠道ID	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
indexId_chanelId	唯一	index_id, chanel_id	BTREE	—
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：历史兼容。 保存广告位与渠道的旧版投放范围关系，仍有维护和兼容匹配路径。关闭规则模式时设备查询使用旧渠道/MAC/地区关系；开启规则模式时使用规则中心，不能把旧表关系视为当前规则的完整覆盖。

launcher_index_mac

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键，自增长	auto_increment
index_id	bigint	是	NULL	广告位索引ID;0-11共12个	—
mac	varchar(255)	是	NULL	mac地址	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
indexId_mac	唯一	index_id, mac	BTREE	—
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：历史兼容。 保存广告位与MAC的旧版投放范围关系，仍有维护和兼容匹配路径。关闭规则模式时设备查询使用旧渠道/MAC/地区关系；开启规则模式时使用规则中心，不能把旧表关系视为当前规则的完整覆盖。

launcher_index_region

BASE TABLE；引擎 InnoDB；表排序规则 utf8mb4_zh_0900_as_cs。

字段	类型	可空	默认值	数据库字段注释	附加属性
id	bigint	否	NULL	主键，自增长	auto_increment
index_id	bigint	是	NULL	广告位索引ID;0-11共12个	—
region_id	bigint	是	NULL	国家地区ID	—
valid	tinyint	是	NULL	是否有效;0-未生效，1-已生效，2-已生效且做修改标记，3-已生效且做移除标记	—

索引（括号内数字为前缀长度，联合列严格按顺序列出）

索引名	性质	列顺序	方法	注释
indexId_regionId	唯一	index_id, region_id	BTREE	—
PRIMARY	主键	id	BTREE	—

本表无物理外键。

业务与查询

使用情况：历史兼容。 保存广告位与地区的旧版投放范围关系，仍有维护和兼容匹配路径。关闭规则模式时设备查询使用旧渠道/MAC/地区关系；开启规则模式时使用规则中心，不能把旧表关系视为当前规则的完整覆盖。

分区设计

本库各表未声明分区，查询主要使用主键和业务索引。

本库查询要点

先用主配置ID定位广告位，再用广告位ID定位资源。历史渠道/MAC/地区表与当前规则范围分别解释。播放与执行追查优先按时间、广告位和设备缩小TD数据范围；MySQL配置表的索引不等同于时序反馈的查询能力。

数据库清单 · 查询与性能 · 主要业务关系