.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
] extents
table
all
from
sourceTableNameto
table
DestinationTableName [ with
(
PropertyName=
PropertyValue [,
...])
]
Az azonosító által megadott mértékek áthelyezése:
.move
[async
] extents
from
table
SourceTableNameto
table
DestinationTableName [ with
(
PropertyName=
PropertyValue [,
...])
] (
GUID [,
...])
A lekérdezési eredmények által megadott mértékek áthelyezése:
.move
[async
] extents
table
to
DestinationTableName [ 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 true van á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 MyTable
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)
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 |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: