Comando .set stored_query_result
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Define um mecanismo que armazena um resultado de consulta no serviço por até 24 horas.
Se um nome de resultado de consulta armazenado já existir, .set
falhará. Em vez disso, use .set-or-replace
, que exclui o resultado da consulta armazenada existente e cria um novo com o mesmo nome.
Permissões
Você deve ter permissões de Visualizador de Banco de Dados para executar esses comandos.
Sintaxe
.set
[async
] stored_query_result
StoredQueryResultName [with
(
PropertyName =
PropertyValue [,
...]])
<|
Consulta
.set-or-replace
[async
] stored_query_result
StoredQueryResultName [with
(
PropertyName =
PropertyValue [,
...]])
<|
Consulta
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
async |
string |
Se especificado, o comando retornará e continuará a ingestão em segundo plano. Use o comando returned OperationId with para recuperar o status e os .show operations resultados da conclusão da ingestão. |
|
Nome_doResultado_daConsulta_Armazenada | string |
✔️ | Nome do resultado da consulta armazenada que adere às regras de nomes de entidade. |
PropertyName, PropertyValue | string |
Uma ou mais propriedades com suporte. | |
Consulta | string |
✔️ | O texto de uma consulta cujos resultados serão armazenados. |
Propriedades aceitas
Propriedade | Type | Descrição |
---|---|---|
expiresAfter |
timespan |
Determina quando o resultado da consulta armazenada expira. O máximo é de 24 horas. |
previewCount |
int |
O número de linhas a serem retornadas em uma visualização. Definir essa propriedade como 0 (padrão) faz com que o comando retorne todas as linhas de resultado da consulta. A propriedade é ignorada quando o comando é invocado usando async o modo. |
Devoluções
Um subconjunto tabular dos registros produzidos pela consulta, conhecido como "visualização" ou todos os registros. Independentemente de quantos registros são mostrados na devolução, todos os registros são armazenados.
Limitação de caracteres
O comando falhará se a consulta gerar um nome de entidade com o $
caractere. Os nomes de entidade devem estar em conformidade com as regras de nomenclatura, portanto, o $
caractere deve ser removido para que o comando de ingestão seja bem-sucedido.
Por exemplo, na consulta a seguir, o search
operador gera uma coluna $table
. Para armazenar os resultados da consulta, use project-rename para renomear a coluna.
.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table
Exemplos
O exemplo a seguir cria um resultado de consulta armazenado chamado Numbers
.
.set stored_query_result Numbers <| range X from 1 to 1000000 step 1
Saída
X |
---|
1 |
2 |
3 |
... |