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 já existir um nome de resultado de consulta armazenado, .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.
Observação
Este comando não pode ser cancelado. O comando .cancel operation só é suportado para ingestão de comandos de consulta e não pode ser usado para cancelar outros comandos.
Permissões
Você deve ter Visualizador de Banco de Dados permissões para executar esses comandos.
Sintaxe
.set [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Query
.set-or-replace [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Query
Saiba mais sobre convenções de sintaxe.
Parâmetros
| Designação | Tipo | Necessário | Descrição |
|---|---|---|---|
async |
string |
Se especificado, o comando retornará e continuará a ingestão em segundo plano. Use o OperationId retornado com o comando .show operations para recuperar o status e os resultados da conclusão da ingestão. |
|
| StoredQueryResultName | string |
✔️ | Nome do resultado da consulta armazenado que adere a nomes de entidade regras. |
| PropertyName, PropertyValue | string |
Uma ou mais propriedades suportadas . | |
| de consulta | string |
✔️ | O texto de uma consulta cujos resultados serão armazenados. |
Propriedades suportadas
| Propriedade | Tipo | 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 o modo async. |
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 no retorno, 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 ingest seja bem-sucedido.
Por exemplo, na consulta a seguir, o operador search 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
Output
| X |
|---|
| 1 |
| 2 |
| 3 |
| ... |