本目录下文档适用于神策基础数据平台新架构版本,未切换到新版本的用户可以在「数据接入」模块中查看相关帮助信息。

1. 概述

神策系统中创建或注册的数据表,均可以在「数据表管理」页面中查看到,包括实体中使用的表、创建的标签、分群的表,以及在服务器上通过 SQL 创建的数据表等。

此外,您可在此创建数据表,编辑数据表的显示信息、唯一键信息,以及设置表数据权限等。

2. 创建数据表

点击「数据表管理」列表页右上角的「创建数据表」按钮,进入创建页面。

创建页涉及以下三个模块的内容:数据表信息、SQL 逻辑配置、以及权限设置。

数据表信息

  1. 所属 DB:展示该数据表将要存储的数据库(Database)名称,无需自行填写。
  2. 表显示名:填写表的显示名,最多100个字符,当前数据库内唯一
  3. 业务方显示状态:用于配置该表在各业务方的显示/隐藏状态。取消勾选后,在业务方隐藏该表,但不影响相关资源的计算。
    1. 目前可配置的业务方有:业务集市、指标平台

SQL 逻辑配置

接下来需要配置数据表的结构,您可以根据需求创建物理表或者视图表。

创建物理表时,可直接在右侧的 SQL 输入框填写建表语句;创建视图表时,可以先在左侧目录查找需要引用的表结构,再在右侧输入语句。

具体建表语句请参考:SQL 语句建表使用指南

表数据权限

用于控制在任务管理等功能使用该数据表的权限,默认全部成员可使用。

  • 可以调整该表的数据权限
    • 修改为「全部对象」:即该项目内全部成员都可使用该表
    • 修改为「指定对象」:可根据账号、角色来进行授权
  • 创建者始终拥有该表的数据权限,不可取消

提交

所有内容填写完成后,您可以点击页面右上角的「提交」按钮来创建数据表。

创建成功后,数据表的表结构不可更改。

3. 数据表列表

您可以通过列表页对当前项目中的数据表进行查看和管理,在页面顶部可以对表名、所属 DB、表类型、来源类别、业务方显示状态等信息进行搜索和筛选。

点击右侧的「查看」按钮可查看该表的详情页。

点击「编辑」按钮可对数据表的部分信息进行编辑,具体功能说明请见下方章节。


4. 数据表详情

每张数据表均包含自身对应的属性,这些属性在列表和详情页中均有展示;具体涉及以下内容:

分类名称说明
基础信息表名称表名称,单个 DB 内名称唯一
表显示名表显示名称,单个 DB 内显示名唯一,支持中文
来源类别说明数据表的来源方,如自定义表、用户表、事件表、标签、分群等等
业务方显示状态

用于控制该数据表在不同业务方的显示和隐藏,目前可以调整数据表在「指标平台」和「业务集市」中的展示状态。

注意:业务方可能包含其他过滤条件,具体可参考相关业务方的说明文档

创建人数据表的创建人
创建时间数据表的创建时间
最后更新人表最后一次被发起变更后的操作人
最后更新时间表最后一次被发起变更后的操作时间
技术信息



所属 DB表归属的 DataBase
表类型包含物理表、视图表
所属引擎

只有物理表包含「所属引擎」信息,视图表该字段会显示为「-」,包含的引擎说明如下:

  • 主键表
    携带主键的物理表
  • 非主键表
    非时序、无主键的物理表

  • 没有引擎信息的视图表
字段信息


字段名

字段名称,单个表内名称唯一

字段显示名字段显示名称,单个表内名称唯一,支持中文
数据类型字段自身的数据类型
主键字段标记了主键字段,支持设置联合主键
唯一键字段

标记了唯一键字段,可用于创建数据表之间的关联关系,支持设置联合唯一键。

分区字段信息-

与字段信息相似,对于设置了分区的非主键表,会在此展示分区字段对应的字段名、字段显示名、字段类型

表数据权限-

拥有该权限,可在任务管理等功能使用该数据表;创建人始终拥有该表的数据权限。

拥有「管理数据表」权限的账号,可以修改相应表的授权;可修改为「全部对象」可用该表,或根据账号、角色来进行授权。

5. 编辑数据表

只有拥有「管理数据表」的权限,且管理范围包括当前表时,可以编辑数据表。

点击列表页或详情页的「编辑」按钮,进入编辑页面,您可以对以下内容进行编辑:

基础信息

  1. 表显示名:可自行修改显示名。
  2. 业务方显示状态:可根据需求,自行修改显示状态。

表结构信息

  1. 支持修改字段显示名
  2. 唯一键字段:唯一键可用于创建维度关联关系,或者在指标平台中创建数据表的关联关系。为了正常使用,请确保唯一键的值非空且唯一。
    1. 对于用户表:不支持配置唯一键,可使用 id 和 用户标识字段进行关联。
    2. 对于主键表:唯一键与主键字段一致,不可以修改。
    3. 对于非主键表或者视图表:您可以自行标记或者修改唯一键,唯一键字段仅能选择“数值”、“整数”、“长整型”和“字符串”类型,最多可标记 5 个字段联合构成唯一键。

权限设置

有权限的账号/角色可以修改表数据权限

提交

修改完成后,您可以点击右上角的「提交」按钮进行保存。

请注意,如果您对唯一键字段进行了修改,提交后可能会影响使用了该唯一键的数据表关联关系,请慎重操作。

6. 权限

  • 若有「查看数据表」的权限,则可进入「数据表管理」页面查看数据表信息。
  • 若有「管理数据表」权限,可以创建、管理数据表:
    • 管理「全部」:可以编辑「数据表管理」页面中所有的表
    • 管理「我创建的」:只能编辑创建者为当前账号的数据表