Comando .set stored_query_result

2025-06-22

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.

Nota

Esse comando não pode ser cancelado. O comando operação .cancel só tem suporte para ingestão de comandos de de consulta e não pode ser usado para cancelar outros comandos.

Permissões

Você deve ter permissões de Visualizador de Banco de Dados para executar esses comandos.

Sintaxe

.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	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	Digitar	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 versão prévia (o padrão é 10K). Definir essa propriedade para `0` fazer 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
...

Compartilhar via