Pozyskiwanie z zapytania (.set, .append, .set-or-append, .set-or-replace)

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Te polecenia wykonują zapytanie lub polecenie zarządzania i pozyskując wyniki zapytania w tabeli. Różnica między tymi poleceniami polega na tym, jak traktują istniejące lub nieistniejących tabel i danych.

Aby anulować pozyskiwanie z polecenia zapytania, zobacz cancel operation.

Uprawnienia

Aby wykonać różne akcje w tabeli, wymagane są określone uprawnienia:

• Aby dodać wiersze do istniejącej tabeli przy użyciu .append polecenia , potrzebujesz co najmniej uprawnień narzędzia Table Ingestor.
• Aby utworzyć nową tabelę przy użyciu różnych .set poleceń, musisz mieć co najmniej uprawnienia użytkownika bazy danych.
• Aby zastąpić wiersze w istniejącej tabeli za pomocą .set-or-replace polecenia , musisz mieć co najmniej uprawnienia administratora tabeli.

Aby uzyskać więcej informacji na temat uprawnień, zobacz Kusto role-based access control (Kontrola dostępu oparta na rolach w usłudze Kusto).

Składnia

(.set.set-or-append.set-or-replace | | .append | ) [async] tableName [with( propertyName = propertyValue [, ...]] <| )queryOrCommand

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

Parametry

Wskazówki dotyczące wydajności

• distributed Ustaw właściwość na true wartość , jeśli ilość danych generowanych przez zapytanie jest duża, przekracza 1 GB i nie wymaga serializacji. Następnie wiele węzłów może generować dane wyjściowe równolegle. Nie używaj tej flagi, gdy wyniki zapytania są małe, ponieważ może niepotrzebnie generować wiele małych fragmentów danych.
• Pozyskiwanie danych to operacja intensywnie korzystająca z zasobów, która może mieć wpływ na współbieżne działania w bazie danych, w tym uruchamianie zapytań. Unikaj uruchamiania zbyt wielu poleceń pozyskiwania w tym samym czasie.
• Ogranicz dane pozyskiwania do mniej niż 1 GB na operację pozyskiwania. W razie potrzeby użyj wielu poleceń pozyskiwania.

Obsługiwane właściwości pozyskiwania

Zagadnienia dotyczące schematu

• .set-or-replacezachowuje schemat, chyba że ustawiono truejedną z właściwości pozyskiwania extend_schema lub recreate_schema .
• .set-or-append polecenia i .append zachowują schemat, chyba że właściwość pozyskiwania extend_schema jest ustawiona na true.
• Dopasowanie schematu zestawu wyników do tabeli docelowej jest oparte na typach kolumn. Nie ma pasujących nazw kolumn. Upewnij się, że kolumny schematu wyników zapytania są w tej samej kolejności co tabela, inne dane zostaną pozyskane do nieprawidłowych kolumn.

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 Texas <| search State has 'Texas' | project-rename tableName=$table

Przykłady

Utwórz nową tabelę o nazwie RecentErrors w bazie danych, która ma ten sam schemat co LogsTable i przechowuje wszystkie rekordy błędów z ostatniej godziny.

.set RecentErrors <|
   LogsTable
   | where Level == "Error" and Timestamp > now() - time(1h)

Utwórz nową tabelę o nazwie "OldExtents" w bazie danych, która ma jedną kolumnę "ExtentId" i przechowuje identyfikatory zakresu wszystkich zakresów w bazie danych, które zostały utworzone ponad 30 dni temu. Baza danych ma istniejącą tabelę o nazwie "MyExtents". Ponieważ zestaw danych powinien być większy niż 1 GB (więcej niż ok. 1 milion wierszy), użyj flagi rozproszonej

.set async OldExtents with(distributed=true) <|
   MyExtents 
   | where CreatedOn < now() - time(30d)
   | project ExtentId

Dołącz dane do istniejącej tabeli o nazwie "OldExtents" w bieżącej bazie danych zawierającej jedną kolumnę "ExtentId" i przechowują identyfikatory zakresu wszystkich zakresów w bazie danych, które zostały utworzone ponad 30 dni wcześniej. Oznacz nowy zakres tagami tagA i tagB, na podstawie istniejącej tabeli o nazwie "MyExtents".

.append OldExtents with(tags='["TagA","TagB"]') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId

Dołącz dane do tabeli "OldExtents" w bieżącej bazie danych lub utwórz tabelę, jeśli jeszcze nie istnieje. Otaguj nowy zakres za pomocą polecenia ingest-by:myTag. Zrób to tylko wtedy, gdy tabela nie zawiera jeszcze zakresu oznaczonego tagiem ingest-by:myTag, na podstawie istniejącej tabeli o nazwie "MyExtents".

.set-or-append async OldExtents with(tags='["ingest-by:myTag"]', ingestIfNotExists='["myTag"]') <|
   MyExtents
   | where CreatedOn < now() - time(30d)
   | project ExtentId

Zastąp dane w tabeli "OldExtents" w bieżącej bazie danych lub utwórz tabelę, jeśli jeszcze nie istnieje. Otaguj nowy zakres za pomocą polecenia ingest-by:myTag.

.set-or-replace async OldExtents with(tags='["ingest-by:myTag"]', ingestIfNotExists='["myTag"]') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId

Dołącz dane do tabeli "OldExtents" w bieżącej bazie danych, ustawiając czas tworzenia zakresów na określoną datę/godzinę w przeszłości.

.append async OldExtents with(creationTime='2017-02-13T11:09:36.7992775Z') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId     

Zwracanie danych wyjściowych

Zwraca informacje o zakresach utworzonych z .set powodu polecenia lub .append .

Przykładowe dane wyjściowe