创建单物理表服务单元

单物理表服务单元用于对业务数据源的单个物理表进行元数据配置。后续您可以基于该单物理表服务单元开发访问该物理表数据的API。本文为您介绍如何创建单物理表服务单元。

前提条件

  • 已完成服务单元分组的创建。具体操作,请参见创建服务项目分组

  • 当数据源类型为Hbase 0.9.4/1.1.x/1.2.1/2.x、ElasticSearch或MongoDB时,需要完成元数据的创建。具体操作,请参见创建元数据

使用限制

支持项目管理员开发用户创建服务单元。如果没有创建服务单元的权限,您可以申请该权限。具体操作,请参见管理服务单元权限

步骤一:选择服务单元类型

  1. 在Dataphin首页,单击顶部菜单栏服务。系统默认进入市场页面。

  2. 按照下图操作指引,进入服务单元类型选择对话框中。

    image.png

  3. 服务单元类型选择对话框,选择单物理表服务单元后,单击确定

步骤二:配置单物理表服务单元参数

  1. 新建服务单元页面,配置服务单元的基础信息和单元字段。

    1. 服务单元基础信息配置

      image.png

      参数

      描述

      服务单元名称

      服务单元的名称。命名规则如下:

      • 只能包含字母、数字和下划线(_)。

      • 以字母开头。

      • 长度在4~64个字符范围内。

      服务单元分组

      选择已创建的服务单元分组。

      模式

      模式用于定义服务单元读取的数据是来自开发数据源还是开发生产数据源。模式包括BasicDev-Prod模式:

      • Basic:选择了Basic模式后,服务单元读取数据时您只能选择到生产数据源。

      • Dev-Prod:选择了Dev-Prod模式后,服务单元读取数据时您可以选择开发数据源和生产数据源。

      您可以在数据源页面,查看您的数据源是生产数据源还是开发数据源。fgagag

      物理数据表

      您可根据数据源类型、数据源筛选物理表。也可以单击新增数据源引入新的业务数据源,以便基于新的业务数据源创建服务单元。如何新增数据源,请参见创建数据源

      支持的数据源类型,包括MySQLAnalyticDB for MySQL2.0ElasticsearchHbase0.9.4/1.1.x/2.xOracleMicrosoft SQL ServerPostgreSQLMongoDBAnalyticDB for MySQL3.0AnalyticDB for PostgreSQLHologresDM

      服务单元描述

      填写对服务单元简单的描述。不超过128个字符。

      最大返回条数

      Dataphin默认最大返回条数为1000条,支持最大限制为10000条。

      用于定义API查询数据时返回的条数,避免一次查询过多数据导致OLTP内存溢出。如果需要查询所有更多数据,您可以在调用API的SDK中修改PageSize参数值,以实现查询API时返回更多的数据。

      如果已有的服务单元与您配置的基础信息相似,则Dataphin会自动为您展示相似服务单元的名称,您可以在服务单元列表中查看该服务单元详细信息。如果需要继续创建新的服务单元,则单击继续新建,即可进入配置服务单元字段页面。gagag

    2. 配置服务单元字段。

      image.png

      参数

      描述

      服务单元字段类型

      支持选择的字段类型包括Double、Float、String、Date、Boolean、Int、Long、Short、Byte、Bigdecimal、Binary。您需要根据业务数据表中字段的类型选择对应的参数类型。

      如果业务数据表的字段类型不在待选参数类型范围内,推荐您选择String。

      服务单元字段

      • 支持自定义勾选部分源表字段作为服务单元字段,对源表新增字段也可在编辑时添加勾选。

      • 配置数据源中字段映射到服务单元中的字段名称,您可以根据业务情况自定义字段名称。命名规则如下:

        • 只能包含字母、数字和下划线(_)。

        • 以字母开头。

        • 长度在4~64个字符范围内。

      • 在编辑单物理表服务单元时,系统如果判断到源表字段已删除,则支持删除该服务单元字段,提交配置后,在引用该服务单元新建API时,不会有该字段,避免调用API时因源表字段不存在而失败。

      服务单元字段描述

      填写对服务单元字段简单的描述。

      完成服务单元字段的配置后,单击页面下方的数据预览,查看字段对应的业务数据。最多返回1000条数据。image.png

  2. 单击提交,完成单物理表服务单元的创建。

后续步骤

  • 在服务单元页面,单击操作列下的image.png图标,选择发布,将单物理表服务单元提交至生产环境,后续就可基于此单物理表服务单元创建API。详情请参见API任务概述

  • 物理表服务单元创建完成后,您可在服务单元页面执行编辑、发布、删除等操作。详情请参见查看及管理服务单元