本目录下文档适用于神策基础数据平台新架构版本,未切换到新版本的用户可以在「数据接入」模块中查看相关帮助信息。
1. 概述
神策系统中创建或注册的数据表,均可以在「数据表管理」页面中查看到,包括实体中使用的表、创建的标签、分群的表,以及在服务器上通过 SQL 创建的数据表等。
此外,您可在此创建数据表,编辑数据表的显示信息、唯一键信息,以及设置表数据权限等。
2. 创建数据表
点击「数据表管理」列表页右上角的「创建数据表」按钮,进入创建页面。

创建页涉及以下三个模块的内容:数据表信息、SQL 逻辑配置、以及权限设置。
数据表信息
- 所属 DB:展示该数据表将要存储的数据库(Database)名称,无需自行填写。
- 表显示名:填写表的显示名,最多100个字符,当前数据库内唯一
- 业务方显示状态:用于配置该表在各业务方的显示/隐藏状态。取消勾选后,在业务方隐藏该表,但不影响相关资源的计算。
- 目前可配置的业务方有:业务集市、指标平台
SQL 逻辑配置
接下来需要配置数据表的结构,您可以根据需求创建物理表或者视图表。
创建物理表时,可直接在右侧的 SQL 输入框填写建表语句;创建视图表时,可以先在左侧目录查找需要引用的表结构,再在右侧输入语句。
具体建表语句请参考:SQL 语句建表使用指南
表数据权限
用于控制在任务管理等功能使用该数据表的权限,默认全部成员可使用。
- 可以调整该表的数据权限
- 修改为「全部对象」:即该项目内全部成员都可使用该表
- 修改为「指定对象」:可根据账号、角色来进行授权
- 创建者始终拥有该表的数据权限,不可取消

提交
所有内容填写完成后,您可以点击页面右上角的「提交」按钮来创建数据表。
创建成功后,数据表的表结构不可更改。
3. 数据表列表
您可以通过列表页对当前项目中的数据表进行查看和管理,在页面顶部可以对表名、所属 DB、表类型、来源类别、业务方显示状态等信息进行搜索和筛选。
点击右侧的「查看」按钮可查看该表的详情页。
点击「编辑」按钮可对数据表的部分信息进行编辑,具体功能说明请见下方章节。

4. 数据表详情
每张数据表均包含自身对应的属性,这些属性在列表和详情页中均有展示;具体涉及以下内容:
分类 | 名称 | 说明 |
---|
基础信息 | 表名称 | 表名称,单个 DB 内名称唯一 |
表显示名 | 表显示名称,单个 DB 内显示名唯一,支持中文 |
来源类别 | 说明数据表的来源方,如自定义表、用户表、事件表、标签、分群等等 |
业务方显示状态 | 用于控制该数据表在不同业务方的显示和隐藏,目前可以调整数据表在「指标平台」和「业务集市」中的展示状态。 注意:业务方可能包含其他过滤条件,具体可参考相关业务方的说明文档 |
创建人 | 数据表的创建人 |
创建时间 | 数据表的创建时间 |
最后更新人 | 表最后一次被发起变更后的操作人 |
最后更新时间 | 表最后一次被发起变更后的操作时间 |
技术信息
| 所属 DB | 表归属的 DataBase |
表类型 | 包含物理表、视图表 |
所属引擎 | 只有物理表包含「所属引擎」信息,视图表该字段会显示为「-」,包含的引擎说明如下: - 主键表
携带主键的物理表 - 非主键表
非时序、无主键的物理表 - 无
没有引擎信息的视图表
|
字段信息
| 字段名 | 字段名称,单个表内名称唯一 |
字段显示名 | 字段显示名称,单个表内名称唯一,支持中文 |
数据类型 | 字段自身的数据类型 |
主键字段 | 标记了主键字段,支持设置联合主键 |
唯一键字段 | 标记了唯一键字段,可用于创建数据表之间的关联关系,支持设置联合唯一键。 |
分区字段信息 | - | 与字段信息相似,对于设置了分区的非主键表,会在此展示分区字段对应的字段名、字段显示名、字段类型 |
表数据权限 | - | 拥有该权限,可在任务管理等功能使用该数据表;创建人始终拥有该表的数据权限。 拥有「管理数据表」权限的账号,可以修改相应表的授权;可修改为「全部对象」可用该表,或根据账号、角色来进行授权。 |

5. 编辑数据表
只有拥有「管理数据表」的权限,且管理范围包括当前表时,可以编辑数据表。
点击列表页或详情页的「编辑」按钮,进入编辑页面,您可以对以下内容进行编辑:

基础信息
- 表显示名:可自行修改显示名。
- 业务方显示状态:可根据需求,自行修改显示状态。
表结构信息
- 支持修改字段显示名
- 唯一键字段:唯一键可用于创建维度关联关系,或者在指标平台中创建数据表的关联关系。为了正常使用,请确保唯一键的值非空且唯一。
- 对于用户表:不支持配置唯一键,可使用 id 和 用户标识字段进行关联。
- 对于主键表:唯一键与主键字段一致,不可以修改。
- 对于非主键表或者视图表:您可以自行标记或者修改唯一键,唯一键字段仅能选择“数值”、“整数”、“长整型”和“字符串”类型,最多可标记 5 个字段联合构成唯一键。
权限设置
有权限的账号/角色可以修改表数据权限
提交
修改完成后,您可以点击右上角的「提交」按钮进行保存。
请注意,如果您对唯一键字段进行了修改,提交后可能会影响使用了该唯一键的数据表关联关系,请慎重操作。
6. 权限
- 若有「查看数据表」的权限,则可进入「数据表管理」页面查看数据表信息。
- 若有「管理数据表」权限,可以创建、管理数据表:
- 管理「全部」:可以编辑「数据表管理」页面中所有的表
- 管理「我创建的」:只能编辑创建者为当前账号的数据表