获取sql模版
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Query |
string |
是 |
检索词 |
sale |
| MaxResults |
integer |
否 |
本次响应对应的最大返回条数。 |
20 |
| NextToken |
string |
否 |
下一次查询的令牌（Token）。 |
f056501ada12**** |
| Tag |
string |
否 |
sql 模版标签 |
new_sales |
| DatabaseUuid |
string |
否 |
关联的数据库 uuid |
md-HZ-fp9K7r*** |
| CatalogUuid |
string |
否 |
关联的目录 uuid |
mc-HZ-OfjcNc2z*** |
| EnableVectorSearch |
boolean |
否 |
是否通过语义检索 |
true |
| Uuids |
string |
否 |
知识实例的 UUID 列表。多个 UUID 之间使用半角逗号（,）分隔。 |
86c5c290052147c***,56c5c2900dasqw*** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
67E910F2-4B62-5B0C-ACA3-7547695C**** |
| Data |
array |
返回结构体 |
|
| OneMetaSqlTemplateView |
返回结构体 |
||
| Success |
boolean |
请求是否成功，返回值如下：
|
true |
| ErrorCode |
string |
错误码，请求异常时返回。 |
UnknownError |
| ErrorMessage |
string |
调用失败时，返回的错误信息。 |
UnknownError |
| NextToken |
string |
下一次查询的令牌（Token）。 |
NesLoKLEdIZrKhDT7I2gS**** |
| MaxResults |
integer |
分页大小。 |
20 |
示例
正常返回示例
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": "UnknownError",
"ErrorMessage": "UnknownError",
"NextToken": "NesLoKLEdIZrKhDT7I2gS****",
"MaxResults": 20
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。