.move extents parancs

Ez a parancs egy adott adatbázis környezetében fut. A megadott mértékeket áthelyezi a forrástáblából a céltáblába.

Megjegyzés

• A mértékekkel kapcsolatos további információkért lásd: Mértékek (adats szegmensek) áttekintése.
• A .move parancsok vagy befejeződnek vagy meghiúsulnak az összes forrásfok esetében. Nincsenek részleges eredmények.

Engedélyek

Legalább Table Rendszergazda engedélyekkel kell rendelkeznie a forrás- és céltáblákhoz.

Korlátozások

• A forrás- és céltábláknak is a környezeti adatbázisban kell lenniük.
• A forrástábla összes oszlopa várhatóan azonos nevű és adattípusú lesz a céltáblában.
• Ha a céltábla egy materializált nézet forrástáblája, a parancs meghiúsulhat, mivel a materializált nézet nem fogja feldolgozni a rekordokat az áthelyezett mértékben. További részletekért lásd a materializált nézetek korlátozásait ismertető oldalon. Ezt a hibát áthidalhatja egy új betöltési idő beállításával az áthelyezési parancs során. Lásd setNewIngestionTime a támogatott tulajdonságokat.

Syntax

Az összes mérték áthelyezése:

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

Az azonosító által megadott mértékek áthelyezése:

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

A lekérdezési eredmények által megadott mértékek áthelyezése:

.move[async] extentstabletoDestinationTableName [ with(PropertyName=PropertyValue [,...])] <|Lekérdezés

További információ a szintaxis konvenciókról.

Paraméterek

Név	Típus	Kötelező	Leírás
async	string		Ha meg van adva, a parancs aszinkron módon fut.
SourceTableName	string	✔️	Az áthelyezni kívánt mértékeket tartalmazó tábla neve.
DestinationTableName	string	✔️	Annak a táblának a neve, amelyre át szeretné helyezni a mértékeket.
PropertyName, PropertyValue	string		Egy vagy több támogatott tulajdonság.
Lekérdezés	string	✔️	A Kusto lekérdezésnyelv (KQL) lekérdezés eredményei határozzák meg a forrástáblát és az áthelyezendő azonosítók mértékét. Egy "ExtentId" és "TableName" nevű rekordhalmazt kell visszaadnia.

Támogatott tulajdonságok

Tulajdonság neve	Típus	Kötelező	Leírás
setNewIngestionTime	bool		Ha a értékre truevan állítva, a rendszer új betöltési időt rendel az áthelyezendő összes rekordhoz. Ez akkor hasznos, ha a rekordokat olyan számítási feladatoknak kell feldolgoznia, amelyek az adatbázis-kurzoroktól, például a materializált nézetektől és a folyamatos adatexportálástól függenek.
extentCreatedOnFrom	datetime	✔️	Alkalmazza az adott időpont után létrehozott mértékeket.
extentCreatedOnTo	datetime	✔️	Alkalmazza az ezen időpont előtt létrehozott mértékeket.

Megjegyzés

A jobb teljesítmény érdekében állítsa be extentCreatedOnFrom és extentCreatedOnTo a paramétereket a lehető legkisebb tartományra.

Válaszok

Ha a parancs szinkronban fut, a rendszer a következő sémával rendelkező táblát adja vissza.

Kimeneti paraméter	Típus	Description
OriginalExtentId	string	Egyedi azonosító (GUID) a forrástáblában szereplő eredeti mértékhez, amelyet áthelyeztek a céltáblába.
ResultExtentId	string	A forrástáblából a céltáblába áthelyezett eredménytartomány egyedi azonosítója (GUID). Hiba esetén – "Sikertelen".
Részletek	string	Tartalmazza a hiba részleteit, ha a művelet meghiúsul.

Ha a parancs aszinkron módon fut, a rendszer egy műveletazonosítót (GUID) ad vissza. Figyelje a művelet állapotát a .show operations paranccsal, és kérje le a sikeres végrehajtás eredményeit a .show operation details paranccsal.

Példák

Minden mérték áthelyezése

Helyezze át a tábla MyTable összes kiterjedését a táblába MyOtherTable:

.move extents all from table MyTable to table MyOtherTable

Két konkrét mérték áthelyezése egy megadott létrehozási időtartományban

Helyezzen át két konkrét terjedelmet (a mértékük alapján) egy megadott létrehozási időtartományban tábláról táblára MyTableMyOtherTable:

.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)

Adott létrehozási időtartományban lévő összes mérték áthelyezése adott táblákból

A megadott létrehozási időtartományban lévő összes mérték áthelyezése adott táblákból (MyTable1, MyTable2) táblázatba MyOtherTable:

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

Az összes mérték áthelyezése az új betöltési idő beállításával

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

Példakimenet

OriginalExtentId	ResultExtentId	Részletek
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