系统支持通过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。