文档首页> 数据湖探索 DLI> API参考> SQL模板相关API> 查看所有SQL模板
更新时间：2023-11-27 GMT+08:00
查看PDF

查看所有SQL模板

功能介绍

该接口用查看用户保存的所有SQL模板。

URI

  • URI格式：

    GET /v1.0/{project_id}/sqls

  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    项目编号，用于资源隔离。获取方式请参考获取项目ID。
    表2 query参数

    参数名称

    是否必选

    参数类型

    说明

    keyword

    否

    String

    用于过滤SQL模板的关键字。

请求参数

无

响应参数

表3 响应参数说明

名称

参数类型

说明

is_success

Boolean

是否成功。

message

String

系统提示信息，执行成功时，信息可能为空。执行失败时，用于显示执行失败的原因。

sql_count

Int

SQL模板总数。

sqls

Array of Object

SQL模板信息，具体参数说明请参见表4。
表4 sqls参数说明

名称

参数类型

说明

sql_id

String

SQL模板ID。

sql_name

String

SQL模板名称。

sql

String

SQL模板文本。

description

String

SQL模板描述信息。

owner

String

SQL模板的创建者。

group

String

SQL模板分组名称。

请求示例

无

响应示例

{
  "is_success": true,
  "message": "",
  "sql_count": 1,
  "sqls": [
    {
      "description": "use to select t1",
      "owner": "tenant1",
      "sql": "select * from t1",
      "sql_id": "1994b029-3f76-4281-9e35-e370cb4ee26d1501998934432",
      "sql_name": "sql1",
      "group": ""
    }
  ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： SQL模板相关API