QueryLumaWithSQL - 在 Luma Agent 所属的 EventHouse 上直接执行 SQL 查询并返回结构化结果 - 事件总线EventBridge

在 Luma Agent 所属的 EventHouse 上直接执行 SQL 查询并返回结构化结果。与 AskLuma 不同，本接口执行调用方给定的 SQL，不做自然语言改写。

接口说明

在 Luma Agent 所属的 EventHouse 上直接执行 SQL 查询并返回结构化结果。与 AskLuma 不同，本接口执行调用方给定的 SQL，不做自然语言改写。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
AgentName	string	是	Agent 名称	my_agent
Sql	string	是	仅支持查询语句	SELECT * FROM my_table LIMIT 10
MaxRows	integer	否	超出部分被截断，响应中的 IsTruncated 会标记截断	100

返回参数

名称	类型	描述	示例值
	object
Message	string	接口返回的提示信息，成功时为 Operation success，失败时为具体错误描述	Operation success
RequestId	string	本次请求的唯一标识，用于问题排查与工单反馈	34AD682D-5B91-5773-8132-AA38C130****
Data	ExecutionResult	SQL 查询的执行结果，包含列定义与行数据
Code	string	接口返回码，Success 表示成功，失败时为具体错误码	Success
Success	boolean	本次调用是否成功，true 表示成功	true

示例

正常返回示例

JSON格式

{
  "Message": "Operation success",
  "RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
  "Data": {
    "IsTruncated": false,
    "RowCount": 2,
    "Rows": "[[\"北京\",120],[\"上海\",98]] ",
    "Schema": [
      {
        "Name": "name",
        "Type": "VARCHAR"
      }
    ],
    "TotalRows": 2
  },
  "Code": "Success",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息
400	InvalidParameter	The specified parameter is invalid
400	ExecutionFailed	Query execution failed
403	ServiceNotEnable	Service not enable
404	AgentNotFound	Agent not found
404	ResourceNotFound	The specified resource is not bound to the agent

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

变更历史

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