单物理表服务单元用于对业务数据源的单个物理表进行元数据配置。后续您可以基于该单物理表服务单元开发访问该物理表数据的API。本文为您介绍如何创建单物理表服务单元。
前提条件
使用限制
支持项目管理员和开发用户创建服务单元。如果没有创建服务单元的权限,您可以申请该权限。具体操作,请参见管理服务单元权限。
步骤一:选择服务单元类型
在Dataphin首页,单击顶部菜单栏服务。系统默认进入市场页面。
按照下图操作指引,进入服务单元类型选择对话框中。
在服务单元类型选择对话框,选择单物理表服务单元后,单击确定。
步骤二:配置单物理表服务单元参数
在新建服务单元页面,配置服务单元的基础信息和单元字段。
服务单元基础信息配置
参数
描述
服务单元名称
服务单元的名称。命名规则如下:
只能包含字母、数字和下划线(_)。
以字母开头。
长度在4~64个字符范围内。
服务单元分组
选择已创建的服务单元分组。
模式
模式用于定义服务单元读取的数据是来自开发数据源还是开发生产数据源。模式包括Basic和Dev-Prod模式:
Basic:选择了Basic模式后,服务单元读取数据时您只能选择到生产数据源。
Dev-Prod:选择了Dev-Prod模式后,服务单元读取数据时您可以选择开发数据源和生产数据源。
您可以在数据源页面,查看您的数据源是生产数据源还是开发数据源。
物理数据表
您可根据数据源类型、数据源筛选物理表。也可以单击新增数据源引入新的业务数据源,以便基于新的业务数据源创建服务单元。如何新增数据源,请参见创建数据源。
支持的数据源类型,包括MySQL、AnalyticDB for MySQL2.0、Elasticsearch、Hbase0.9.4/1.1.x/2.x、Oracle、Microsoft SQL Server、PostgreSQL、MongoDB、AnalyticDB for MySQL3.0、AnalyticDB for PostgreSQL、Hologres。
服务单元描述
填写对服务单元简单的描述。不超过128个字符。
最大返回条数
Dataphin默认最大返回条数为1000条,支持最大限制为10000条。
用于定义API查询数据时返回的条数,避免一次查询过多数据导致OLTP内存溢出。如果需要查询所有更多数据,您可以在调用API的SDK中修改PageSize参数值,以实现查询API时返回更多的数据。
如果已有的服务单元与您配置的基础信息相似,则Dataphin会自动为您展示相似服务单元的名称,您可以在服务单元列表中查看该服务单元详细信息。如果需要继续创建新的服务单元,则单击继续新建,即可进入配置服务单元字段页面。
配置服务单元字段。
参数
描述
服务单元字段类型
支持选择的字段类型包括Double、Float、String、Date、Boolean、Int、Long、Short、Byte、Bigdecimal、Binary。您需要根据业务数据表中字段的类型选择对应的参数类型。
如果业务数据表的字段类型不在待选参数类型范围内,推荐您选择String。
服务单元字段
支持自定义勾选部分源表字段作为服务单元字段,对源表新增字段也可在编辑时添加勾选。
配置数据源中字段映射到服务单元中的字段名称,您可以根据业务情况自定义字段名称。命名规则如下:
只能包含字母、数字和下划线(_)。
以字母开头。
长度在4~64个字符范围内。
在编辑单物理表服务单元时,系统如果判断到源表字段已删除,则支持删除该服务单元字段,提交配置后,在引用该服务单元新建API时,不会有该字段,避免调用API时因源表字段不存在而失败。
服务单元字段描述
填写对服务单元字段简单的描述。
完成服务单元字段的配置后,单击页面下方的数据预览,查看字段对应的业务数据。最多返回1000条数据。
单击提交,完成单物理表服务单元的创建。