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-replace
qui 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 |
... |