CreateOneMetaSqlTemplate - 创建SQL模版-数据管理 DMS-阿里云帮助中心

创建sql模版

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Source	string	是	sql 模版知识来源	DATA_AGENT
Title	string	是	sql 模版标题	ecommerce_sales
Description	string	否	sql 模版描述	sales template
Tag	string	否	sql 模版标签	sales
DatabaseUuid	string	否	关联的数据库 uuid	md-HZ-fp9K7r***
CatalogUuid	string	否	关联的目录 uuid	mc-HZ-OfjcNc2z***
Expr	string	是	sql 模版内容	SELECT SUM(amount) AS total_sales FROM store_daily_sales
SqlParams	string	否	模版参数，自定义	{"start_day_id": "2026-08-01", "end_day_id": "2026-08-16"}

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	67E910F2-4B62-5B0C-ACA3-7547695C****
Data	OneMetaSqlTemplateView	返回结构体。
Success	boolean	请求是否成功，返回值如下： true：请求成功。 false：请求失败。	true
ErrorCode	string	请求异常时返回的错误码。	InternalError
ErrorMessage	string	调用失败时，返回的出错信息。	ServerUnrecognizedException

示例

正常返回示例

JSON格式

{
  "RequestId": "67E910F2-4B62-5B0C-ACA3-7547695C****",
  "Data": {
    "KnowledgeUuid": "86c5c290052147c***",
    "Source": "DATA_AGENT",
    "Title": "ecommerce_sales",
    "Description": "sales count",
    "Summary": "sales summary",
    "Tag": "new_sales",
    "DatabaseUuid": "md-HZ-fp9K7r***",
    "CatalogUuid": "mc-HZ-OfjcNc2z***",
    "Expr": "SELECT store_name, daily_sales FROM store_daily_sales ORDER BY daily_sales DESC LIMIT 5",
    "SqlParams": "{\"dt\": \"2026-08-01\"}",
    "Version": "0.1",
    "GmtCreated": 1787302285000,
    "GmtModified": 1787302285000
  },
  "Success": true,
  "ErrorCode": "InternalError",
  "ErrorMessage": "ServerUnrecognizedException"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。