Partager via


Commande .set stored_query_result

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Définit un mécanisme qui stocke un résultat de requête sur le service pendant jusqu’à 24 heures.

Si un nom de résultat de requête stocké existe déjà, .set échoue. Utilisez plutôt , .set-or-replacequi supprime le résultat de la requête stockée existante et en crée un nouveau portant le même nom.

autorisations

Vous devez disposer des autorisations de visionneuse de base de données pour exécuter ces commandes.

Syntaxe

.set[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Requête

.set-or-replace[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Requête

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
async string Si elle est spécifiée, la commande retourne et continue l’ingestion en arrière-plan. Utilisez la commande retournée OperationId .show operations pour récupérer l’état et les résultats de l’ingestion.
StoredQueryResultName string ✔️ Nom de résultat de requête stocké qui respecte les règles de noms d’entité.
PropertyName, PropertyValue string Une ou plusieurs propriétés prises en charge.
Requête string ✔️ Texte d’une requête dont les résultats seront stockés.

Propriétés prises en charge

Propriété Type Description
expiresAfter timespan Détermine quand le résultat de la requête stockée expire. La valeur maximale est de 24 heures.
previewCount int Nombre de lignes à retourner dans un aperçu. La définition de cette propriété 0 sur (par défaut) rend la commande renvoyer toutes les lignes de résultat de la requête. La propriété est ignorée lorsque la commande est appelée en async mode.

Retours

Sous-ensemble tabulaire des enregistrements générés par la requête, appelé « aperçu » ou tous les enregistrements. Quel que soit le nombre d’enregistrements affichés lors du retour, tous les enregistrements sont stockés.

Limitation des caractères

La commande échoue si la requête génère un nom d’entité avec le $ caractère. Les noms d’entités doivent respecter les règles d’affectation de noms. Le $ caractère doit donc être supprimé pour que la commande d’ingestion réussisse.

Par exemple, dans la requête suivante, l’opérateur search génère une colonne $table. Pour stocker les résultats de la requête, utilisez le renommage du projet pour renommer la colonne.

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

Exemples

L’exemple suivant crée un résultat de requête stocké nommé Numbers.

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

Sortie

X
1
2
3
...