# 数据表
# 一、数据表的定义
数据表，是将外部数据接入TE系统的一种方式，引入客户自己保存或处理过的数据，通过TE提供的分析工具，或直接作为分析的数据源，或与事件-用户数据结合来使用。
当前，数据表仅支持用于维度表属性使用。
# 二、使用权限
| 大类 | 具体内容 | 公司超管 | 管理员 | 分析师 | 普通成员 |
|---|---|---|---|---|---|
| 元数据查看 | 数据表预览、导出属性的维度表、下载数据表内容、下载数据表历史内容 | ● | ● | ▲ | ○ |
| 元数据编辑 | 新增数据表、编辑数据表、还原数据表历史版本 | ● | ● | ▲ | ○ |
权限说明：
● 角色必有
▲ 角色默认有，可以没有
△ 角色默认没有，可以有
○ 角色必没有
# 三、数据表的使用和维度属性的创建
# 3.1 数据表手动创建
入口：数据管理——>元数据管理——>数据表管理，可以在此界面对数据表进行上传、管理等操作；
点击创建数据表按钮后，可以按照引导上传（UTF-8编码）csv、excel来创建一张全新的数据表，其中excel上限100M，csv上限500M；
上传的表格要求表头必须是以字母开头，包含字母、数字、和下划线“_”，长度最大为50个字符；
上传时，会以首列作为数据表的主键，并进行去重，主键重复的会保留第一次出现的行；
上传后，需要对数据表进行命名，可修改字段类型和显示名；解析完成时，会告知解析失败的行数（可下载错误详情），并预览表格内容。
以 UTF-8 编码格式保存 csv 文件
- Excel 保存方法
根据下图提示，在保存时使用 UTF-8 编码格式，文件类型为 CSV 文件
- 记事本保存方法
根据下图提示，编码选择 UTF-8 ，文件类型改为 CSV 文件
# 3.2 数据表更新和发布
点击更新数据表的按钮，可以对数据表进行更新操作；
当前支持增量更新与替换更新两种方式；
增量更新：
- 要求上传的表头要与当前表格的表头完全一致，首列会作为主键来进行去重；
- 增量更新，会将主键与原有数据表完全不同的数据插入到数据表中，主键相同的会更新原有的数据，以新进入的数据为准；
- 替换更新：
- 要求首列（主键）必须保持一致，其他列的表头可以发生变化；
- 替换更新会将全表的数据进行替换，也可以进行列的变化；
- 替换更新，导致表结构发生变化：
- 表结构变化包括列的增减、列类型的修改两种情况；
- 如果表格结构发生了变化，会影响到已使用了该数据表的其他资产的稳定性，需要进行发布操作后，当前的更新操作才会线上生效；
- 发布：
- 可以在替换更新后直接进入发布界面，也可以从数据表管理界面进入发布界面；
- 发布时，用户需要确认当前的数据表结构变更内容，以及对关联的维度属性的影响，确认无误后发布即可。
# 3.3 维度表属性的创建
数据表当前仅支持通过配置维度属性来进行分析使用，维度属性的使用相关可见：维度表属性与虚拟属性 。当前维度表属性的创建有两种方式，分别在数据表的管理界面、事件属性和用户属性的管理界面。
- 数据表配置维度表属性：
- 点击需要配置的数据表的配置关联属性的按钮，在弹出的窗口进行关联属性的配置，可以进行多组配置，一张数据表可以和最多5个属性配置生成对应的维度表属性；
- 配置的属性，既可以是事件属性，也可以是用户属性；
- 事件属性、用户属性配置维度表属性：
- 一个没有维度表关联的事件属性或用户属性，可以点击关联维度表来进行配置；
- 配置时，可以选择一张已有的数据表进行关联，也可以选择创建一张新的数据表；
- 维度表属性的更新：维度表属性不再支持单独进行更新，更新时需要更新对应的数据表，一次更新，所有关联的维度表属性均会更新；
- V3.8之前配置的维度表属性维护：
- TE界面上，针对之前已经配置好的维度表属性，对维度表进行更新时，需要删除后重新关联新的数据表，之后的更新流程和数据表的更新一致；
- API，仍然可以通过原有的维度表 API进行更新（注意：该API不能用于使用数据表配置的维度属性）。
# 3.4 时间类型主属性，生成维度属性
- 时间类型的事件属性、用户属性，可以以不同的时间粒度，与数据表关联，生成维度属性，目前支持的时间粒度如下：
| 时间粒度 | 格式示例 |
|---|---|
| 年 | 2021 |
| 月 | 2021-07 |
| 日 | 2021-07-31 |
| 小时 | 2021-07-31 09 |
| 分钟 | 2021-07-31 09:16 |
| 秒 | 2021-07-31 09:16:48 |
| 毫秒 | 2021-07-31 09:16:48.270 |
- 关联的时候：
- 要求数据表的主键为“文本”类型，才能关联成功；
- 主键的样式，要和时间粒度的格式完全一致，比如时间粒度选择了年，那么主键应该是“2021”、“2022”、“2019”这样格式的“文本”类型的值，生成的维度属性在用于报表、虚拟属性等其他资产时，才能计算成功；
- 可以在属性管理界面或数据表管理界面，进行时间类型属性与数据表关联的配置，配置过程中，需要选择时间粒度，其他配置过程，与 3.3 维度属性的创建 中的一致；
- 生成的维度属性，使用方式与其他的维度属性一致。
# 3.5 通过openAPI进行数据表的创建、更新和管理
详情可参见 数据表API中的使用说明
# 3.6 数据表的预览、历史版本查看和还原
点击数据表的表名，可以进入数据表详情页，查看数据表的基本信息、数据预览和历史版本；
数据预览可以看到当前数据表的部分；
历史版本，可以看到所有更新的日志，包括表格结构的改变，内容的更新情况；如果当前的版本有问题，需要还原到历史的版本，可以点击还原按钮。
# 四、最佳实践
- 通过数据表，导入英雄列表，与己方英雄ID、敌方英雄ID关联，生成维度属性，应用于分析中，直接使用英雄的各种属性，如英雄类型、英雄名称等；更新时，通过增量更新，更新每次新增的英雄和发生变化的英雄。
- 道具表，可以通过数据表导入TE中，在埋点的多个环节作为维度属性进行使用：商店、背包构成、道具使用；更新时，进行统一的更新，增量更新每次新增的道具和发生变化的道具。
← 维度表属性与虚拟属性 数据集成 →