Executa uma consulta SQL diretamente no EventHouse associado a um Luma Agent e retorna resultados estruturados. Ao contrário do AskLuma, esta operação executa o SQL fornecido pelo chamador sem reescrita em linguagem natural.
Descrição da operação
Executa uma consulta SQL diretamente no EventHouse associado a um Luma Agent e retorna resultados estruturados. Ao contrário do AskLuma, esta operação executa o SQL fornecido pelo chamador sem reescrita em linguagem natural.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| AgentName |
string |
Sim |
O nome do agente. |
my_agent |
| Sql |
string |
Sim |
Somente instruções de consulta são suportadas. |
SELECT * FROM my_table LIMIT 10 |
| MaxRows |
integer |
Não |
As linhas que excedem esse limite são truncadas. O campo IsTruncated na resposta indica se ocorreu truncamento. |
100 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| Message |
string |
A mensagem retornada pela operação. O valor é Operation success se a chamada for bem-sucedida, ou uma descrição de erro específica se a chamada falhar. |
Operation success |
| RequestId |
string |
O identificador exclusivo da solicitação. Use este ID para solução de problemas e ao enviar um ticket. |
34AD682D-5B91-5773-8132-AA38C130**** |
| Data | ExecutionResult |
O resultado da execução da consulta SQL, incluindo definições das colunas e dados das linhas. |
|
| Code |
string |
O código de resposta da operação. O valor Success indica que a chamada foi bem-sucedida. Caso contrário, um código de erro específico é retornado. |
Success |
| Success |
boolean |
Indica se a chamada foi bem-sucedida. O valor true indica sucesso. |
true |
Exemplos
Resposta de sucesso
JSON formato
{
"Message": "Operation success",
"RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
"Data": {
"IsTruncated": false,
"RowCount": 2,
"Rows": "[[\"Pequim\",120],[\"Xangai\",98]]",
"Schema": [
{
"Name": "nome",
"Type": "VARCHAR"
}
],
"TotalRows": 2
},
"Code": "Success",
"Success": true
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 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 |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.