Polecenie .move extents

  • Artykuł

To polecenie jest uruchamiane w kontekście określonej bazy danych. Przenosi określone zakresy z tabeli źródłowej do tabeli docelowej.

Uwaga

Uprawnienia

Musisz mieć co najmniej uprawnienia tabeli Administracja dla tabel źródłowych i docelowych.

Ograniczenia

  • Zarówno tabele źródłowe, jak i docelowe muszą znajdować się w bazie danych kontekstowej.
  • Wszystkie kolumny w tabeli źródłowej powinny istnieć w tabeli docelowej o tej samej nazwie i typie danych.
  • Jeśli tabela docelowa jest tabelą źródłową zmaterializowanego widoku, polecenie może zakończyć się niepowodzeniem, ponieważ zmaterializowany widok nie przetworzy rekordów w przeniesionych zakresach. Zobacz więcej szczegółów na stronie zmaterializowanych ograniczeń widoków . Ten błąd można obejść, ustawiając nowy czas pozyskiwania podczas przenoszenia polecenia. Zobacz setNewIngestionTime w obsługiwanych właściwościach.

Składnia

Przenieś wszystkie zakresy:

.move [async] extentsallfromtablesourceTableNametotableDestinationTableName [ with(PropertyName=PropertyValue [, ...])]

Przenieś zakresy określone przez identyfikator:

.move[async] extentsfromtableSourceTableName DestinationTableNametotable [ with(PropertyName=PropertyValue [, ...])] (Identyfikator GUID [, ...])

Przenieś zakresy określone przez wyniki zapytania:

.move [async] extentstotableDestinationTableName [ with(PropertyName=PropertyValue [,...])] <|Kwerendy

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
async string Jeśli to określone, polecenie jest uruchamiane asynchronicznie.
SourceTableName string ✔️ Nazwa tabeli zawierającej zakresy do przeniesienia.
Destinationtablename string ✔️ Nazwa tabeli, do której mają być przenoszone zakresy.
PropertyName, PropertyValue string Co najmniej jedna obsługiwana właściwości.
Zapytanie string ✔️ Wyniki tego zapytania język zapytań Kusto (KQL) określają tabelę źródłową i identyfikatory zakresu, z których mają zostać przeniesione. Powinien zwrócić zestaw rekordów z kolumnami o nazwie "ExtentId" i "TableName".

Obsługiwane właściwości

Nazwa właściwości Typ Wymagane Opis
setNewIngestionTime bool Jeśli ustawiono truewartość , zostanie przypisany nowy czas pozyskiwania do wszystkich rekordów w zakresach, które są przenoszone. Jest to przydatne, gdy rekordy powinny być przetwarzane przez obciążenia zależne od kursorów bazy danych, takich jak zmaterializowane widoki i ciągły eksport danych.
extentCreatedOnFrom datetime ✔️ Zastosuj w zakresach utworzonych po tym punkcie w czasie.
extentCreatedOnTo datetime ✔️ Zastosuj do zakresów utworzonych przed tym punktem w czasie.

Uwaga

Aby uzyskać lepszą wydajność, ustaw extentCreatedOnFrom parametry i extentCreatedOnTo na najmniejszy możliwy zakres.

Zwraca

Gdy polecenie jest uruchamiane synchronicznie, zwracana jest tabela z następującym schematem.

Parametr wyjściowy Typ Opis
OriginalExtentId string Unikatowy identyfikator (GUID) dla oryginalnego zakresu w tabeli źródłowej, który został przeniesiony do tabeli docelowej.
ResultExtentId string Unikatowy identyfikator (GUID) dla zakresu wyników, który został przeniesiony z tabeli źródłowej do tabeli docelowej. Po awarii — "Niepowodzenie".
Szczegóły string Zawiera szczegóły błędu, jeśli operacja zakończy się niepowodzeniem.

Gdy polecenie jest uruchamiane asynchronicznie, zwracany jest identyfikator operacji (GUID). Monitoruj stan operacji za pomocą polecenia .show operations i pobierz wyniki pomyślnego wykonania za pomocą polecenia .show operation details .

Przykłady

Przenieś wszystkie zakresy

Przenieś wszystkie zakresy w tabeli MyTable do tabeli MyOtherTable:

.move extents all from table MyTable to table MyOtherTable

Przenoszenie dwóch określonych zakresów w określonym zakresie czasu tworzenia

Przenieś dwa określone zakresy (według identyfikatorów zakresu) w określonym zakresie czasu tworzenia z tabeli MyTable do tabeli MyOtherTable:

.move extents from table MyTable to table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) (AE6CD250-BE62-4978-90F2-5CB7A10D16D7,399F9254-4751-49E3-8192-C1CA78020706)

Przenoszenie wszystkich zakresów w określonym zakresie czasu tworzenia z określonych tabel

Przenieś wszystkie zakresy w określonym zakresie czasu tworzenia z określonych tabel (MyTable1, MyTable2) do tabeli MyOtherTable:

.move extents to table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show tables (MyTable1,MyTable2) extents

Przenieś wszystkie zakresy z ustawionym nowym czasem pozyskiwania

.move extents all from table MyTable to table MyOtherTable with (setNewIngestionTime=true)

Przykładowe dane wyjściowe

OriginalExtentId ResultExtentId Szczegóły
e133f050-a1e2-4dad-8552-1f5cf47cab69 0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687
cdbeb35b-87ea-499f-b545-defbae091b57 a90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c 97afea1-59ff-4312-b06b-08f42187872f
2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df