多物理表服务单元用于关联多个物理表,并对关联后的字段进行元数据配置。后续您可以基于该多物理表服务单元开发可以同时访问多物理表数据的API,以实现联合数据查询。本文为您介绍如何创建多物理表服务单元。
前提条件
使用限制
支持项目管理员和开发用户创建服务单元。如果没有创建服务单元的权限,您可以申请该权限。具体操作,请参见管理服务单元权限。
注意事项
只有当主物理表与非主物理表中某字段值和字段类型相同时,后续基于该多物理表服务单元创建的API才可以实现联合数据查询,否则无法实现联合数据查询。
步骤一:选择服务单元类型
在Dataphin首页,单击顶部菜单栏服务。系统默认进入市场页面。
按照下图操作指引,进入服务单元类型选择对话框。
在服务单元类型选择对话框,选择多物理表服务单元后,单击确定。
步骤二:配置多物理表服务单元参数
在新建服务单元页面,配置服务单元的基础信息和参数信息。
服务单元基础信息配置
参数
描述
服务单元名称
服务单元的名称。命名规则如下:
只能包含字母、数字和下划线(_)。
以字母开头。
长度在4~64个字符范围内。
服务单元分组
选择已创建的服务单元分组。
模式
模式用于定义服务单元读取的数据是来自开发数据源还是开发生产数据源。模式包括Basic和Dev-Prod模式:
Basic:选择了Basic模式后,服务单元读取数据时您只能选择到生产数据源。
Dev-Prod:选择了Dev-Prod模式后,服务单元读取数据时您可以选择开发数据源和生产数据源。
您可以在数据源页面,查看您的数据源是生产数据源还是开发数据源。
服务单元描述
填写对服务单元简单的描述。不超过128字符。
最大返回条数
Dataphin默认最大返回条数为1000条,支持最大限制为10000条。
用于定义API查询数据时返回的条数,避免一次查询过多数据导致OLTP内存溢出。如果需要查询所有更多数据,您可以在调用API的SDK中修改PageSize参数值,以实现查询API时返回更多的数据。
添加物理表
单击添加物理表,在新增物理表对话框,添加需要读取数据的多个物理表。
Dataphin默认将添加的第一个物理表设为主表,您也可以选择其他物理表为主表。
多个物理表间的计算逻辑是JOIN,主表即左连接计算时的左表,其他表则为右表。后续您需要选择左表中的某个字段作为多个物理表的关联字段,该字段在调用API时会作为传参。如果调用SQL语句中没有该字段,则调用API会失败。
如果已有的服务单元与您配置的基础信息相似,则Dataphin会自动为您展示相似服务单元的名称,您可以在服务单元列表中查看该服务单元详细信息。如果需要继续创建新的服务单元,则单击继续新建,即可进入配置服务单元字段页面。
配置服务单元字段。
参数
描述
配置服务单元关联字段
服务单元字段
您可以自定义服务单元字段名称。命名规则如下:
只能包含字母、数字和下划线(_)。
以字母开头。
长度在4~64个字符范围内。
主表名称.关联字段(主键)
从主表中选择与已关联的非主表的字段值相同的字段,后续该关联字段在调用API时会作为传参。如果调用SQL语句中没有该关联字段,则调用API会失败。
服务单元关联字段类型
选择关联主表的字段类型。
服务单元字段描述
填写对服务单元关联字段简单的描述。
配置服务单元字段
服务单元字段类型
支持选择的字段类型包括Double、Float、String、Date、Boolean、Int、Long、Short、Byte、Bigdecimal、Binary。您需要根据业务数据的实际字段类型选择对应的关联字段类型。
如果业务数据的字段类型不在上述字段类型范围内,推荐您选择String。
服务单元字段
配置业务数据的字段映射到服务单元中的字段名称,您可以根据业务情况自定义字段名称。命名规则如下:
只能包含字母、数字和下划线(_)。
以字母开头。
长度在4~64个字符范围内。
服务单元字段描述
填写对服务单元字段简单的描述。
完成服务单元字段的配置后,单击页面下方的数据预览,查看字段对应的业务数据。最多返回1000条数据。
单击提交,完成多物理表服务单元的创建。