Consulta o conteúdo de um modelo semântico usando SPL.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
log:QueryContextModel |
list |
*ContextModel
|
Nenhuma | Nenhuma |
Sintaxe da solicitação
POST /context-models/{name}/query HTTP/1.1
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| name |
string |
Não |
O identificador do modelo de contexto a ser consultado. Ele é obtido a partir do caminho da solicitação /context-models/{name}/query. São aceitas apenas letras maiúsculas e minúsculas, dígitos, sublinhados (_) e hifens (-). |
orders |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| body |
object |
Não |
O corpo da solicitação. Um objeto JSON que contém uma consulta SPL para as definições de elementos do modelo. |
|
| query |
string |
Sim |
A instrução de consulta SPL. Este parâmetro é obrigatório e não pode ser uma string vazia. Caso contrário, um erro 400 será retornado. Ele usa .umodel como fonte de dados para consultar as definições de elementos do modelo. Operações de pipeline como where, project e limit são suportadas. Exemplo: .umodel | where kind = 'log_set' | limit 50. |
.umodel | where kind = 'log_set' | limit 50 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O corpo da resposta que contém os nomes das colunas e as linhas de dados correspondentes à consulta. |
||
| data |
array |
O array de linhas de resultado. Cada linha é um array cujos elementos correspondem um a um, em ordem, ao cabeçalho. Um array vazio [] é retornado se nenhuma correspondência for encontrada. |
|
|
array |
Uma linha de resultado. A ordem dos elementos corresponde um a um aos nomes das colunas no cabeçalho. |
||
|
string |
O valor da célula, que é sempre uma string. Os valores nas colunas metadata, schema e spec são strings JSON que o chamador deve analisar. |
log_set |
|
| header |
array |
O array de nomes de colunas. As colunas variam com base na projeção na consulta SPL. Se nenhuma projeção explícita for especificada, as colunas padrão são kind, metadata, schema e spec. |
|
|
string |
O nome da coluna. |
kind |
Exemplos
Resposta de sucesso
JSON formato
{
"data": [
[
"log_set"
]
],
"header": [
"kind"
]
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.