Opdracht .set stored_query_result
Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-
Hiermee stelt u een mechanisme in waarmee een queryresultaat gedurende maximaal 24 uur op de service wordt opgeslagen.
Als er al een naam voor het opgeslagen queryresultaat bestaat, mislukt .set. Gebruik in plaats daarvan .set-or-replace, waarmee het bestaande opgeslagen queryresultaat wordt verwijderd en er een nieuwe met dezelfde naam wordt gemaakt.
Notitie
Deze opdracht kan niet worden geannuleerd. De .cancel-bewerking opdracht wordt alleen ondersteund voor opname uit query- opdrachten en kan niet worden gebruikt om andere opdrachten te annuleren.
Machtigingen
U moet Database Viewer machtigingen hebben om deze opdrachten uit te voeren.
Syntaxis
.set [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Query
.set-or-replace [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Query
Meer informatie over syntaxisconventies.
Parameters
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
async |
string |
Indien opgegeven, wordt de opdracht geretourneerd en wordt de opname op de achtergrond voortgezet. Gebruik de geretourneerde OperationId met de opdracht .show operations om de voltooiingsstatus en resultaten van de opname op te halen. |
|
| StoredQueryResultName | string |
✔️ | Naam van opgeslagen queryresultaten die voldoet aan entiteitsnamen regels. |
| PropertyName, PropertyValue | string |
Een of meer ondersteunde eigenschappen. | |
| Query- | string |
✔️ | De tekst van een query waarvan de resultaten worden opgeslagen. |
Ondersteunde eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
expiresAfter |
timespan |
Bepaalt wanneer het opgeslagen queryresultaat verloopt. Maximum is 24 uur. |
previewCount |
int |
Het aantal rijen dat moet worden geretourneerd in een voorbeeld. Als u deze eigenschap instelt op 0 (standaard), wordt met de opdracht alle rijen met queryresultaten geretourneerd. De eigenschap wordt genegeerd wanneer de opdracht wordt aangeroepen met behulp van async modus. |
Retourneert
Een subset in tabelvorm van de records die door de query worden geproduceerd, aangeduid als de preview of alle records. Ongeacht het aantal records dat bij retour wordt weergegeven, worden alle records opgeslagen.
Tekenbeperking
De opdracht mislukt als de query een entiteitsnaam genereert met het $ teken. De namen van de entiteiten moeten voldoen aan de naamgevingsregels, zodat het $ teken moet worden verwijderd om de opdracht opname te voltooien.
In de volgende query genereert de operator search bijvoorbeeld een kolom $table. Als u de queryresultaten wilt opslaan, gebruikt u projectnaam om de naam van de kolom te wijzigen.
.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table
Voorbeelden
In het volgende voorbeeld wordt een opgeslagen queryresultaat gemaakt met de naam Numbers.
.set stored_query_result Numbers <| range X from 1 to 1000000 step 1
uitvoer
| X |
|---|
| 1 |
| 2 |
| 3 |
| ... |