Comando .set stored_query_result
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati
Imposta un meccanismo che archivia un risultato della query nel servizio per un massimo di 24 ore.
Se esiste già un nome di risultato della query archiviato, .set ha esito negativo. Usare invece .set-or-replace, che elimina il risultato della query archiviata esistente e ne crea uno nuovo con lo stesso nome.
Autorizzazioni
Per eseguire questi comandi, è necessario disporre delle autorizzazioni del Visualizzatore di database.
Sintassi
.set[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Quesito
.set-or-replace[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Quesito
Altre informazioni sulle convenzioni di sintassi.
Parametri
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
async |
string |
Se specificato, il comando restituirà e continuerà l'inserimento in background. Usare l'oggetto restituito OperationId con il .show operations comando per recuperare lo stato di completamento dell'inserimento e i risultati. |
|
| StoredQueryResultName | string |
✔️ | Nome del risultato della query archiviato conforme alle regole dei nomi di entità. |
| PropertyName, PropertyValue | string |
Una o più proprietà supportate. | |
| Query | string |
✔️ | Testo di una query i cui risultati verranno archiviati. |
Proprietà supportate
| Proprietà | Type | Descrizione |
|---|---|---|
expiresAfter |
timespan |
Determina quando scade il risultato della query archiviata. Il valore massimo è 24 ore. |
previewCount |
int |
Numero di righe da restituire in un'anteprima. Se si imposta questa proprietà su 0 (impostazione predefinita) il comando restituisce tutte le righe dei risultati della query. La proprietà viene ignorata quando il comando viene richiamato tramite async la modalità . |
Valori restituiti
Subset tabulare dei record prodotti dalla query, denominata "anteprima" o tutti i record. Indipendentemente dal numero di record visualizzati in caso di restituzione, tutti i record vengono archiviati.
Limitazione dei caratteri
Il comando ha esito negativo se la query genera un nome di entità con il $ carattere . I nomi delle entità devono essere conformi alle regole di denominazione, pertanto il $ carattere deve essere rimosso affinché il comando di inserimento abbia esito positivo.
Nella query seguente, ad esempio, l'operatore search genera una colonna $table. Per archiviare i risultati della query, usare project-rename per rinominare la colonna.
.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table
Esempi
Nell'esempio seguente viene creato un risultato della query archiviato denominato Numbers.
.set stored_query_result Numbers <| range X from 1 to 1000000 step 1
Output
| X |
|---|
| 1 |
| 2 |
| 3 |
| ... |