Udostępnij za pośrednictwem

Polecenie .set stored_query_result

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Ustawia mechanizm, który przechowuje wynik zapytania w usłudze przez maksymalnie 24 godziny.

Jeśli nazwa przechowywanego wyniku zapytania już istnieje, .set nie powiedzie się. Zamiast tego użyj polecenia .set-or-replace, który usuwa istniejący przechowywany wynik zapytania i tworzy nowy o tej samej nazwie.

Uprawnienia

Aby uruchomić te polecenia, musisz mieć uprawnienia przeglądarki baz danych.

Składnia

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

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

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
async string Jeśli zostanie określony, polecenie zwróci i będzie kontynuować pozyskiwanie w tle. Użyj zwróconego OperationId polecenia , .show operations aby pobrać stan ukończenia pozyskiwania i wyniki.
StoredQueryResultName string ✔️ Przechowywana nazwa wyniku zapytania zgodna z regułami nazw jednostek.
PropertyName, PropertyValue string Co najmniej jedna obsługiwana właściwości.
Zapytanie string ✔️ Tekst zapytania, którego wyniki będą przechowywane.

Obsługiwane właściwości

Właściwość Type Opis
expiresAfter timespan Określa, kiedy wygasa przechowywany wynik zapytania. Wartość maksymalna to 24 godziny.
previewCount int Liczba wierszy do zwrócenia w wersji zapoznawczej. Ustawienie tej właściwości na 0 (wartość domyślna) powoduje, że polecenie zwraca wszystkie wiersze wyników zapytania. Właściwość jest ignorowana, gdy polecenie jest wywoływane przy użyciu async trybu.

Zwraca

Tabelaryczny podzbiór rekordów generowanych przez zapytanie, określany jako "wersja zapoznawcza" lub wszystkie rekordy. Niezależnie od liczby rekordów wyświetlanych po powrocie wszystkie rekordy są przechowywane.

Ograniczenie znaków

Polecenie kończy się niepowodzeniem, jeśli zapytanie generuje nazwę jednostki z znakiem $ . Nazwy jednostek muszą być zgodne z regułami nazewnictwa, więc $ znak musi zostać usunięty, aby polecenie pozyskiwania powiodło się.

Na przykład w poniższym zapytaniu search operator generuje kolumnę $table. Aby zapisać wyniki zapytania, użyj nazwy projektu, aby zmienić nazwę kolumny.

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

Przykłady

Poniższy przykład tworzy przechowywany wynik zapytania o nazwie Numbers.

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

Wyjście

X
1
2
3
...

Powiązana zawartość