Partilhar via

.set stored_query_result comando

  • Artigo

Define um mecanismo que armazena um resultado de consulta no serviço durante um máximo de 24 horas.

Se já existir um nome de resultado de consulta armazenado, .set falha. Em vez disso, utilize .set-or-replace, que elimina o resultado da consulta armazenada existente e cria um novo com o mesmo nome.

Permissões

Tem de ter permissões de Visualizador de Bases de Dados para executar estes comandos.

Syntax

.set [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Consulta

.set-or-replace [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Consulta

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
async string Se for especificado, o comando irá devolver e continuar a ingestão em segundo plano. Utilize o devolvido OperationId com o .show operations comando para obter os resultados e o estado de conclusão da ingestão.
StoredQueryResultName string ✔️ Nome do resultado da consulta armazenada que cumpre as regras de nomes de entidades .
PropertyName, PropertyValue string Uma ou mais propriedades suportadas.
Query string ✔️ O texto de uma consulta cujos resultados serão armazenados.

Propriedades suportadas

Propriedade Tipo Description
expiresAfter timespan Determina quando o resultado da consulta armazenada expira. O máximo é de 24 horas.
previewCount int O número de linhas a devolver numa pré-visualização. Definir esta propriedade como 0 (predefinição) faz com que o comando devolva todas as linhas de resultados da consulta. A propriedade é ignorada quando o comando é invocado através do async modo .

Devoluções

Um subconjunto tabular dos registos produzidos pela consulta, referido como "pré-visualização" ou todos os registos. Independentemente do número de registos apresentados na devolução, todos os registos são armazenados.

Limitação de carateres

O comando falha se a consulta gerar um nome de entidade com o $ caráter . Os nomes das entidades têm de estar em conformidade com as regras de nomenclatura, pelo que o $ caráter tem de ser removido para que o comando de ingestão seja bem-sucedido.

Por exemplo, na seguinte consulta, o search operador gera uma coluna $table. Para armazenar os resultados da consulta, utilize o nome do projeto para mudar o nome da coluna.

.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table

Exemplos

O exemplo seguinte cria um resultado de consulta armazenado com o nome Numbers.

.set stored_query_result Numbers <| range X from 1 to 1000000 step 1

Saída

X
1
2
3
...

Conteúdo relacionado