Comando .set stored_query_result
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
Establece un mecanismo que almacena un resultado de consulta en el servicio durante hasta 24 horas.
Si ya existe un nombre de resultado de consulta almacenado, .set se produce un error. En su lugar, use .set-or-replace, que elimina el resultado de la consulta almacenada existente y crea uno nuevo con el mismo nombre.
Permisos
Debe tener permisos del Visor de bases de datos para ejecutar estos comandos.
Sintaxis
.set[async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...]] <| )Consulta
.set-or-replace[async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...]] <| )Consulta
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
async |
string |
Si se especifica, el comando devolverá y continuará la ingesta en segundo plano. Use el devuelto OperationId con el .show operations comando para recuperar el estado de finalización de la ingesta y los resultados. |
|
| StoredQueryResultName | string |
✔️ | Nombre de resultado de consulta almacenado que cumple las reglas de nombres de entidad. |
| PropertyName, PropertyValue | string |
Una o varias propiedades admitidas. | |
| Consulta | string |
✔️ | Texto de una consulta cuyos resultados se almacenarán. |
Propiedades admitidas
| Propiedad | Tipo | Descripción |
|---|---|---|
expiresAfter |
timespan |
Determina cuándo expira el resultado de la consulta almacenada. El máximo es de 24 horas. |
previewCount |
int |
Número de filas que se van a devolver en una vista previa. Al establecer esta propiedad 0 en (valor predeterminado), el comando devuelve todas las filas de resultados de la consulta. La propiedad se omite cuando se invoca el comando mediante async el modo . |
Devoluciones
Subconjunto tabular de los registros generados por la consulta, denominado "vista previa" o todos los registros. Independientemente del número de registros que se muestran a la devolución, se almacenan todos los registros.
Limitación de caracteres
Se produce un error en el comando si la consulta genera un nombre de entidad con el $ carácter . Los nombres de entidad deben cumplir las reglas de nomenclatura, por lo que el $ carácter debe quitarse para que el comando ingest se realice correctamente.
Por ejemplo, en la consulta siguiente, el search operador genera una columna $table. Para almacenar los resultados de la consulta, use project-rename para cambiar el nombre de la columna.
.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table
Ejemplos
En el ejemplo siguiente se crea un resultado de consulta almacenado denominado Numbers.
.set stored_query_result Numbers <| range X from 1 to 1000000 step 1
Salida
| X |
|---|
| 1 |
| 2 |
| 3 |
| ... |