系统支持通过SQL语句配置服务单元字段及查询条件生成API。本文为您介绍如何通过自定义SQL模式新建API。

前提条件

操作步骤

  1. 进入个人工作台
  2. 个人后台页面,单击左侧导航栏服务开发下的API
  3. API页面,单击页面右上角的新建API
  4. 新建API配置向导页面,完成以下操作。
    1. 选择API的创建方式。
      1. API的创建方式选择为自定义SQL模式
      2. 单击下一步
    2. 配置API基础信息。
      1. 配置参数。gaga
        参数 描述
        API名称 API名称由汉字、英文、数字或下划线(_)组合组成。
        请求方式 请求方式包括:
        • GET
        • LIST
        数据更新频率 数据更新频率包括:
        • 每天
        • 每小时
        • 每分钟
        描述 填写对API简单的描述。
        协议 选择通过API同步数据的协议。协议包括:
        • HTTP
        • HTTPS
      2. 单击下一步
    3. 配置参数。
      1. 参数配置页面,配置参数。GAGAGA
        编号 参数 描述
        API SQL脚本编辑 API SQL脚本编辑框中输入SQL语句。 您可以将鼠标悬停至gaga图标,查看SQL脚本的限制。
        服务单元 系统支持选择多物理表服务单元、单物理表服务单元和Dataphin逻辑表:
        • 选择单物理表和多物理表服务单元:
          1. 单击服务单元类型显示框区域内,在下拉列表中选择服务单元类型。
          2. 单击服务单元分组显示框区域内,在下拉列表中选择服务单元分组。
          3. 单击服务单元模式显示框区域内,在下拉列表中选择服务单元模式。
          4. 单击服务单元显示框区域内,在下拉列表中选择服务单元。
        • 添加Dataphin逻辑表:
          1. 单击服务单元类型显示框区域内,在下拉列表中选择Dataphin逻辑表。
          2. 单击模式显示框区域内,在下拉列表中选择数据开发的模式。
          3. 单击业务板块显示框区域内,在下拉列表中选择对应开发模式下的业务板块。
          4. 单击数据表显示框区域内,在下拉列表中选择数据表。
        数据预览 单击数据预览,查看服务单元或逻辑表中的数据。fagaga

        您也可以修改返回条数后,单击刷新数据预览后,查看数据。

        SQL试运行

        在您开始SQL试运行前,需要保证SQL代码语法正确。如果SQL代码语法不正确,则无法进入请求参数输入页面。

        查看API SQL脚本的运行结果:
        1. 单击SQL试运行
        2. 请求参数输入对话框中,试运行输入值输入为数据预览时获取的user_id的数据。fagag
        3. 单击确认,即可开始SQL运行。
          • 如果运行结果返回Success,则SQL语法校验、引擎层校验、底层数据库引擎校验的结果为成功。
          • 如果运行结果返回Error,则SQL语法校验、引擎层校验、底层数据库引擎校验的结果为失败。
        解析参数 单击解析参数后,系统根据API SQL脚本编辑处填写的SQL语句自动归类为请求参数返回参数
        请求参数 配置参数:
        • 单击参数类型显示框区域内,在下拉列表中选择参数类型
        • 示例列下的输入框中,输入示例。
        • 描述列下的输入框中,输入描述。
        • 选择参数为是否必填
        返回参数 配置参数:
        • 单击参数类型显示框区域内,在下拉列表中选择参数类型
        • 示例列下的输入框中,输入示例。
        • 描述列下的输入框中,输入描述。
      2. 单击提交,提交后的API即可进入开发环境。

后续步骤

开发环境的API测试成功后、需要发布至生产环境(数据服务市场),请参见测试与发布API