Dela via

Kommandot .move extents

  • Artikel

Det här kommandot körs i kontexten för en specifik databas. De angivna utrymmena flyttas från källtabellen till måltabellen.

Anteckning

Behörigheter

Du måste ha minst table Admin behörigheter för käll- och måltabellerna.

Begränsningar

  • Både käll- och måltabeller måste finnas i kontextdatabasen.
  • Alla kolumner i källtabellen förväntas finnas i måltabellen med samma namn och datatyp.
  • Om måltabellen är en källtabell i en materialiserad vy kan kommandot misslyckas eftersom den materialiserade vyn inte bearbetar posterna i de flyttade utrymmena. Mer information finns på sidan med begränsningar för materialiserade vyer . Du kan lösa det här felet genom att ange en ny inmatningstid under flyttkommandot. Se setNewIngestionTime i egenskaper som stöds.

Syntax

Flytta alla utrymmen:

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

Flytta utrymmen som anges av ID:

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

Flytta utrymmen som anges av frågeresultat:

.move[async] extentstabletoDestinationTableName [ with(PropertyName=PropertyValue [,...])] <|Fråga

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
async string Om kommandot anges körs det asynkront.
SourceTableName string ✔️ Namnet på tabellen som innehåller de utrymmen som ska flyttas.
DestinationTableName string ✔️ Namnet på tabellen som utrymmena ska flyttas till.
PropertyName, PropertyValue string En eller flera egenskaper som stöds.
Query string ✔️ Resultatet av den här KQL-frågan (Kusto-frågespråk) anger källtabellen och det utrymmes-ID som ska flyttas från den. Ska returnera en postuppsättning med kolumnerna "ExtentId" och "TableName".

Egenskaper som stöds

Egenskapsnamn Typ Obligatorisk Beskrivning
setNewIngestionTime bool Om värdet trueär tilldelas en ny inmatningstid till alla poster i utrymmen som flyttas. Detta är användbart när poster ska bearbetas av arbetsbelastningar som är beroende av databasmarkörer, till exempel materialiserade vyer och kontinuerlig dataexport.
extentCreatedOnFrom datetime ✔️ Tillämpa på utrymmen som skapats efter den här tidpunkten.
extentCreatedOnTo datetime ✔️ Tillämpa på utrymmen som skapats före den här tidpunkten.

Anteckning

För bättre prestanda anger du extentCreatedOnFrom och extentCreatedOnTo parametrarna till det minsta möjliga intervallet.

Returer

När kommandot körs synkront returneras en tabell med följande schema.

Utdataparameter Typ Description
OriginalExtentId string En unik identifierare (GUID) för den ursprungliga omfattningen i källtabellen, som har flyttats till måltabellen.
ResultExtentId string En unik identifierare (GUID) för resultatmängden som har flyttats från källtabellen till måltabellen. Vid fel – "Misslyckades".
Information string Innehåller felinformationen om åtgärden misslyckas.

När kommandot körs asynkront returneras ett åtgärds-ID (GUID). Övervaka åtgärdens status med kommandot .show operations och hämta resultatet av en lyckad körning med kommandot .show operation details .

Exempel

Flytta alla utrymmen

Flytta alla utrymmen i tabellen MyTable till tabellen MyOtherTable:

.move extents all from table MyTable to table MyOtherTable

Flytta två specifika utrymmen inom ett angivet tidsintervall för skapande

Flytta två specifika utrymmen (efter deras utrymmes-ID: er) inom ett angivet tidsintervall för skapande från tabell MyTable till tabell 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)

Flytta alla utrymmen i ett angivet tidsintervall för skapande från specifika tabeller

Flytta alla utrymmen i ett angivet tidsintervall för skapande från specifika tabeller (MyTable1, MyTable2) till tabellen MyOtherTable:

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

Flytta alla utrymmen med angiven ny inmatningstid

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

Exempelutdata

OriginalExtentId ResultExtentId Information
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 97aafea1-59ff-4312-b06b-08f42187872f
2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df