.drop extents parancs

A mértékek elvetése egy megadott adatbázisból vagy táblából.

Ennek a parancsnak több változata van: Az egyikben az elvetendő mértékeket egy Kusto-lekérdezés határozza meg. A többi változatban a mértékek az alább ismertetett mininyelv használatával vannak megadva.

Megjegyzés

Az adatszilánkokat mértékeknek nevezzük, és minden parancs szinonimaként a "extent" vagy a "extents" kifejezést használja. További információ a mértékekről: Extents (Adats szegmensek) áttekintése.

Figyelemfelhívás

Ha elvet egy mértéket, az adott mérték összes sora törlődik. Az egyes rekordok törléséhez használja a Helyreállítható törlés parancsot.

Engedélyek

Ha a TableName paraméter meg van adva, legalább Table Rendszergazda engedéllyel kell rendelkeznie a parancs futtatásához.

Ha a TableName nincs megadva, legalább adatbázis-Rendszergazda engedéllyel kell rendelkeznie a parancs futtatásához.

Syntax

Mértékek elvetése lekérdezéssel

.dropextents [whatif] <|Lekérdezés

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

Paraméterek

Név	Típus	Kötelező	Leírás
whatif	string		Ha meg van adva, a rendszer a mértékeket jelenti ahelyett, hogy elveti őket.
Lekérdezés	string	✔️	A Kusto lekérdezésnyelv (KQL) lekérdezés eredményei határozzák meg a forrástáblákat és az elvetendő azonosítók mértékét. Egy "ExtentId" és "TableName" oszlopokat tartalmazó rekordhalmazt kell visszaadnia.

Adott vagy több kiterjedés elvetése

.dropextents(ExtentIds)fromTableName

Paraméterek

Név	Típus	Kötelező	Leírás
ExtentIds	guid	✔️	Az elvetendő kiterjedések egy vagy több vesszővel tagolt egyedi azonosítója.
TableName	string		Annak a táblának a neve, ahol az elvetendő mérték található.

Mértékek elvetése megadott tulajdonságok alapján

.dropextents[olderN (days | hours)] from (TableName | tablesall) [trimby (extentsizedatasize | ) Méret (MB | GBbytes | )] [limitLimitCount]

Paraméterek

Név	Típus	Kötelező	Leírás
N	int	✔️	Az N napnál/óránál régebbi csökkenési mértékek.
TableName	string		Annak a táblának a neve, ahol az elvetendő mérték található
Méret	int	✔️	Vágja le az adatbázis adatait, amíg a mértékek összege meg nem egyezik a szükséges mérettel (MaxSize).
LimitCount	int	✔️	Az első LimitCount-mértékekre alkalmazva.

A parancs támogatja az emulációs módot, amely kimenetet hoz létre, mintha a parancs futna, de anélkül, hogy ténylegesen végrehajtaná. A helyett használja a következőt .drop-pretend : .drop.

Válaszok

A parancs egy táblát ad vissza az alábbi információkkal.

Kimeneti paraméter	Típus	Description
ExtentId	string	A parancs miatt elvetett ExtentId azonosító
TableName	string	Tábla neve, ahol a mérték tartozik
CreatedOn	dateTime	Időbélyeg, amely információkat tartalmaz arról, hogy a mérték mikor lett eredetileg létrehozva

Egy parancs visszatérési értéke például az alábbi táblázathoz hasonló lehet.

Mérték azonosítója	Táblázat neve	Létrehozva
43c6e03f-1713-4ca7-a52a-5db8a4e8b87d	TestTable	2015-01-12 12:48:49.4298178

Példák

Adott mérték elvetése

Használjon mértékazonosítót egy adott mérték elvetéséhez.

.drop extent 609ad1e2-5b1c-4b79-90c0-1dec262e9f46 from Table1

Több kiterjedés elvetése

A mértékazonosítók listájával több kiterjedést is elvethet.

.drop extents (609ad1e2-5b1c-4b79-90c0-1dec262e9f46, 310a60c6-8529-4cdf-a309-fe6aa7857e1d) from Table1

Az összes kiterjedés eltávolítása a létrehozás időpontja szerint

A több mint 10 nappal ezelőtt létrehozott összes mérték eltávolítása az adatbázis összes táblájából MyDatabase

.drop extents <| .show database MyDatabase extents | where CreatedOn < now() - time(10d)

Bizonyos mértékek eltávolítása a létrehozás időpontja szerint

Távolítsa el a táblák Table1 összes olyan kiterjedését, Table2 amelynek létrehozási ideje több mint 10 nappal ezelőtt volt

.drop extents older 10 days from tables (Table1, Table2)

Mérték eltávolítása extent_id() használatával

Egy mérték eltávolítása egy táblából a beépített extent_id() függvénnyel.

.drop extents  <|
    StormEvents
    | where EventId == '66144'
    | summarize by ExtentId = extent_id(), TableName = "StormEvents"

Emulációs mód: Annak megjelenítése, hogy a parancs mely mértékeket távolítaná el

Megjegyzés

A Extent ID paraméter erre a parancsra nem alkalmazható.

.drop-pretend extents older 10 days from all tables

Az összes mérték eltávolítása a "TestTable" táblából

.drop extents from TestTable

Megjegyzés

Az összes mérték eltávolítása nem feltétlenül törli a táblában lévő összes adatot, ha engedélyezve van a streambetöltés. Egy tábla összes adatának törléséhez használja a parancsot .clear table data TestTable.