在您开始新建API前,需要对数据表进行统一的元数据配置,即新建服务单元。Dataphin支持通过单物理表和多物理表的方式新建服务单元。本文为您介绍如何新建服务单元。
前提条件
- 完成服务单元分组的创建,请参见操作步骤。
- 如果数据源为Hbase、ElasticSearch、MongoDB,完成元数据的创建,请参见创建元数据。
背景信息
- 多物理表服务单元用于基于多张同源或异构物理表生成服务单元。
- 服务单元支持多人协助开发,服务单元列表中展示所有的服务单元。
- 一个服务单元可以对接多个API,即服务单元与API的关系是1:N。
- 服务单元状态说明。
状态 |
描述 |
草稿 |
服务单元保存后,即可成为草稿状态。 |
开发环境服务中 |
服务单元提交后,即可进入开发环境中,并且处于服务中的状态。 |
生产环境服务中 |
服务单元发布后,即可进入生产环境中,并且处于服务中的状态。 |
- 服务单元支持Basic和Dev-Prod模式。
模式 |
使用场景 |
Basic |
数据生产过程稳定且便捷。数据的开发、提交和发布均调用生产环境的数据。 |
Dev-Prod |
保障数据安全的同时,满足应用系统的开发需求,提供基于开发数据库的API调用链路。数据的开发和提交均调用开发环境的数据,数据的发布调用生产环境的数据。 |
使用限制
系统支持超级管理员和开发者角色的成员新建服务单元,更多关于服务单元的操作限制,请参见数据服务权限说明。
新建单物理表服务单元
- 进入个人工作台。
- 在个人工作台页面,单击左侧导航栏的服务单元。
- 在服务单元页面,单击服务单元页面右上角的新建服务单元。
- 在新建服务单元配置向导页面,完成以下操作。
- 服务单元类型选择为单物理表服务单元后,单击下一步。
- 完成服务单元基础信息配置后,单击下一步。

参数 |
描述 |
服务单元名称 |
服务单元名称的命名规则如下:
- 只能包含字母、数字和下划线(_)。
- 以字母开头。
- 长度在4~64个字符范围内。
|
服务单元分组 |
选择已创建的服务单元分组。 |
模式 |
模式用于定义服务单元读取的数据是来自开发数据源还是开发生产数据源。模式包括Basic和Dev-Prod模式:
- Basic:选择了Basic模式后,服务单元读取数据时您只能选择到生产数据源。
- Dev-Prod:选择了Dev-Prod模式后,服务单元读取数据时您可以选择开发数据源和生产数据源。
您可以在数据源页面,查看您的数据源是生产数据源还是开发数据源。 
|
物理数据表 |
选择数据源类型、数据源和数据表。
您也可以单击新增数据源,新建数据源,详细内容请参见数据源。
|
服务单元描述 |
填写对服务单元简单的描述。 |
如果系统中服务单元与您选择信息相似,则系统会自动为您展示相似服务单元的名称,同时提供编辑和查看的操作入口。您可以编辑已有的服务单元或单击
继续新建。
- 配置服务单元字段。
在
配置服务单元字段页面,您可以修改服务单元字段类型和服务单元字段名称。
完成服务单元字段的配置后,单击页面下方的数据预览,查看数据。同时您还可以修改返回条数后,单击刷新数据预览后,查看更新后的数据。
- 单击提交,完成服务单元创建。
- 在服务单元列表页面,鼠标悬停至
图标后,单击发布,发布服务单元至生产环境,即可基于服务单元创建API。

对已发布的服务单元,可以执行如下操作。
操作 |
描述 |
编辑 |
在服务单元页面,单击操作列下的 图标,编辑服务单元。
|
删除 |
在服务单元页面,单击操作列下的 图标,删除服务单元。
说明 仅限服务单元负责人及超级管理员执行删除服务单元的操作。
|
查看 |
在服务单元页面,单击操作列下的 图标,查看开发环境和生产环境中服务单元的详情。
说明 系统仅支持查看生产环境或开发环境在服务中状态的服务单元。
|
新建多物理表服务单元
- 进入个人工作台。
- 在个人工作台页面,单击左侧导航栏的服务单元。
- 单击服务单元页面右上角的新建服务单元。
- 在新建服务单元配置向导页面,完成以下操作。
- 服务单元类型选择为多物理表服务单元后,单击下一步。
- 完成服务单元基础信息配置后,单击下一步。

参数 |
描述 |
服务单元名称 |
服务单元名称的命名规则如下:
- 只能包含字母、数字和下划线(_)。
- 以字母开头。
- 长度在4~64个字符范围内。
|
服务单元分组 |
选择已创建的服务单元分组。 |
模式 |
模式用于定义服务单元读取的数据是来自开发数据源还是开发生产数据源。模式包括Basic和Dev-Prod模式:
- Basic:选择了Basic模式后,服务单元读取数据时您只能选择到生产数据源。
- Dev-Prod:选择了Dev-Prod模式后,服务单元读取数据时您可以选择开发数据源和生产数据源。
您可以在数据源页面,查看您的数据源是生产数据源还是开发数据源。 
|
服务单元描述 |
填写对服务单元简单的描述。 |
挂载物理表列表 |
按照下图操作指引,添加需要读取数据的多个物理表。 Dataphin默认将添加的第一个物理表设为主表,您也可以选择其他物理表为主表。
多个物理表间的计算逻辑是左连接,主表即左连接计算时的左表,其他表则为右表。后续您需要选择左表中的某个字段作为多个物理表的关联字段,该字段在调用API时会作为传参。如果调用SQL语句中没有该字段,则调用API会失败。
|
如果系统中服务单元与您选择的信息接近,则系统会自动为您展示相似服务单元的名称,同时提供编辑和查看的操作入口。您可以编辑已有的服务单元或单击
继续新建。
系统默认将添加的第一个物理表设为主表,您可以单击主表列下的
图标,选择主表。同时,您还可以编辑物理表、编辑已选字段和删除物理表。
- 根据配置服务单元字段页面提示及您的业务场景需求,配置参数。

区域 |
参数 |
描述 |
配置服务单元关联字段 |
服务单元字段 |
您可以自定义服务单元字段名称。命名规则如下:
- 只能包含字母、数字和下划线(_)。
- 以字母开头。
- 长度在4~64个字符范围内。
|
主表名称.关联字段(主键) |
从主表中选择与已关联的非主表的字段值相同的字段,后续该关联字段在调用API时会作为传参。如果调用SQL语句中没有该关联字段,则调用API会失败。 |
非主表名称.关联字段 |
从非主表中选择与已选择的关联主表字段值和字段类型均相同的字段。 |
服务单元关联字段类型 |
选择关联主表的字段类型。 |
配置服务单元字段 |
服务单元字段类型 |
支持选择的字段类型包括Double、Float、String、Date、Boolean、Int、Long、Short、Byte、Bigdecimal、Binary。您需要根据业务数据的实际字段类型选择对应的关联字段类型。
如果业务数据的字段类型不在上述字段类型范围内,推荐您选择String。
|
服务单元字段 |
配置业务数据的字段映射到服务单元中的字段名称,您可以根据业务情况自定义字段名称。命名规则如下:
- 只能包含字母、数字和下划线(_)。
- 以字母开头。
- 长度在4~64个字符范围内。
|
完成服务单元字段的配置后,单击页面下方的数据预览,查看数据。同时您也可以修改返回条数后,单击刷新数据预览后,查看数据。
- 单击提交,完成服务单元创建。
- 在服务单元页面,鼠标悬停至
图标,单击发布,发布服务单元至生产环境,即可基于服务单元创建API。
对已发布的服务单元,可以执行如下操作。
操作 |
描述 |
编辑 |
单击操作列下的 图标,编辑服务单元。
|
删除 |
单击操作列下的 图标,删除服务单元。
说明
- 仅未发布的服务单元支持删除操作。
- 仅限服务单元负责人及超级管理员支持删除服务单元的操作。
|
查看 |
单击操作列下的 图标,查看开发环境和生产环境中服务单元的详情。
说明 系统仅支持查看生产环境或开发环境在服务中状态的服务单元。
|
后续操作
服务单元发布至生产环境后,即可基于服务单元新建API。关于新建API,请参见新建API。