Příkaz .set stored_query_result
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
Nastaví mechanismus, který ukládá výsledek dotazu do služby po dobu až 24 hodin.
Pokud již název výsledku uloženého dotazu existuje, .set selže. Místo toho použijte .set-or-replace, který odstraní existující uložený výsledek dotazu a vytvoří nový s názvem.
Oprávnění
Ke spuštění těchto příkazů musíte mít oprávnění Prohlížeče databáze.
Syntaxe
.set[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Dotaz
.set-or-replace[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )Dotaz
Přečtěte si další informace o konvencích syntaxe.
Parametry
| Název | Type | Požadováno | Popis |
|---|---|---|---|
async |
string |
Pokud je zadáno, příkaz vrátí příjem dat na pozadí a bude pokračovat v příjmu dat. Pomocí vráceného OperationId .show operations příkazu načtěte stav a výsledky dokončení příjmu dat. |
|
| StoredQueryResultName | string |
✔️ | Uložený název výsledku dotazu, který dodržuje pravidla názvů entit. |
| PropertyName, PropertyValue | string |
Jedna nebo více podporovaných vlastností. | |
| Dotaz | string |
✔️ | Text dotazu, jehož výsledky budou uloženy. |
Podporované vlastnosti
| Vlastnost | Type | Popis |
|---|---|---|
expiresAfter |
timespan |
Určuje, kdy vyprší platnost uloženého výsledku dotazu. Maximum je 24 hodin. |
previewCount |
int |
Počet řádků, které se mají vrátit v náhledu Nastavením této vlastnosti na 0 (výchozí) příkaz vrátí všechny řádky výsledků dotazu. Vlastnost je ignorována při vyvolání příkazu pomocí async režimu. |
Návraty
Tabulková podmnožina záznamů vytvořených dotazem, označovaná jako náhled nebo všechny záznamy. Bez ohledu na to, kolik záznamů se při vrácení zobrazuje, jsou všechny záznamy uloženy.
Omezení znaků
Příkaz selže, pokud dotaz vygeneruje název entity se znakem $ . Názvy entit musí splňovat pravidla pojmenování, takže $ znak musí být odebrán, aby příkaz ingestování proběhl úspěšně.
Například v následujícím dotazu search operátor vygeneruje sloupec $table. Pokud chcete uložit výsledky dotazu, přejmenujte sloupec pomocí přejmenování projektu.
.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table
Příklady
Následující příklad vytvoří uložený výsledek dotazu s názvem Numbers.
.set stored_query_result Numbers <| range X from 1 to 1000000 step 1
Výstup
| X |
|---|
| 1 |
| 2 |
| 3 |
| ... |