# 数据表

数据表是系统提供的数据接入方式之一，除此之外，还有SDK 接入。客户可以将自有数据，导入数据表，用于分析。

目前数据表可作为事件属性和用户属性的维度表使用，可通过导入表格文件的方式更新数据表数据。

# 创建数据表

导入一个表格文件即可创建新的数据表（可查看csv 文件保存方法），注意 excel 格式文件不可超过 100M，csv 格式文件不可超过 500M，若数据文件超过上述范围，可在创建后，通过增量更新分多次导入。

新建的数据表列名与上传表格文件的列名（首行）是一致的，用户还需指定各字段的数据类型。注意表格主键的数据类型在创建后是不可变更的，主键数据类型会影响可关联的属性范围，详见下表：

属性数据类型	添加维度表说明
文本，数值，布尔	可添加维度表，表主键数据类型需与属性相同。
时间	可添加维度表，表主键数据类型需为文本，且需与指定时间格式相同。
列表	可添加维度表，表主键数据类型需为文本。
对象，对象组	不可添加维度表属性。对象的子属性可以添加维度表。

在预览界面确认各列数据解析是否正常，表格解析失败的数据行，可通过下载错误详情获取。

表格文件中的数据会自动插入新建表中，若文件中不同行的数据首列值相同，将去重后插入数据表，去重方式为取相同值中最小行号数据。（Tips: 因 Schema 默认上传表的首列为主键，主键的值不能重复，因此会自动去重）

增量更新是一种较轻量的更新方式，仅需在更新时，导入发生变化的少量数据即可，若导入数据的主键字段值在数据表中已存在，则执行更新，若主键字段值不存在，则新插入一条数据。这种更新方式不会影响未出现在导入表格文件中的主键值数据。

由于单次上传文件的大小有限制（excel 格式文件不可超过 100M，csv 格式文件不可超过 500M），如需更新较多的数据，可分多次导入实现。

增量更新的上传表格与当前数据表的结构需完全一致（一致性要求包括列名和列顺序）。

当变更数据范围较大，或者需要删除部分数据时，推荐使用替换更新。这种更新方式将先清空原数据表中数据，再将本次导入表格数据全量写入表中。表格文件的要求同增量更新。

用户还可以通过数据表 API 更新数据表。若用户使用的是 v3.8 之前创建的维度表，可通过维度表 API更新数据。

在数据表界面，可对已创建的数据进行表结构更新、表删除、表及数据的版本还原等管理动作。

若需要调整表字段的显示名，可在增量更新时修改。若需要增减列，或者变更列的数据类型（主键字段不支持数据类型变更），可在替换更新时修改。

表结构变更会影响使用了本数据表的资产，需要发布后方可生效。在列表的发布状态栏，也会提示数据表存在未发布更新。发布时，需确认本次上线的表结构和相关影响。

数据表数据或结构变更后，若需要退回，在数据表版本记录可还原。需注意，还原内容包括数据表结构和数据表内数据，但不包括数据表和属性的关联关系。

数据表删除后不可恢复，如果数据表已被添加为维度表，删除数据表会导致由此创建的维度表属性同步删除。

用户还可以通过数据表 API 管理数据表。

在数据表界面，可直接将数据表添加为一到多个属性的维度表，详情见数据表关联属性。当然，用户也可以在用户属性和事件属性的界面将数据表添加为维度表。

大类	具体内容	公司超管	管理员	分析师	普通成员
元数据查看	数据表预览、导出属性的维度表、下载数据表内容、下载数据表历史内容	●	●	▲	○
元数据编辑	新增数据表、编辑数据表、还原数据表历史版本	●	●	▲	○

权限说明：

● 角色必有

▲ 角色默认有，可以没有

△ 角色默认没有，可以有

○ 角色必没有