Příkaz .drop extents

Zahodí rozsahy ze zadané databáze nebo tabulky.

Tento příkaz má několik variant: V jedné jsou rozsahy, které se mají vynechat, určeny dotazem Kusto. V ostatních variantách jsou rozsahy specifikovány pomocí minijazyčného popisu níže.

Poznámka

Horizontální oddíly dat se nazývají rozsahy a všechny příkazy používají jako synonymum "rozsah" nebo "rozsahy". Další informace o rozsahech najdete v přehledu rozsahů (horizontálních oddílů dat).

Upozornění

Pokud rozsah zahodíte, odstraní se všechny řádky v daném rozsahu. Pokud chcete odstranit jednotlivé záznamy, použijte obnovitelné odstranění.

Oprávnění

Pokud je zadaný název tabulky, musíte mít alespoň oprávnění Table Správa ke spuštění příkazu.

Pokud není název tabulky zadaný, musíte mít alespoň oprávnění k Správa databáze, abyste mohli příkaz spustit.

Syntax

Odstranění rozsahů pomocí dotazu

.dropextents [whatif] <|Dotaz

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Typ	Vyžadováno	Popis
whatif	string		Pokud je zadaný, rozsahy se neoznamují, místo aby se zahodily.
Dotaz	string	✔️	Výsledky tohoto dotazu dotazovací jazyk Kusto (KQL) určují zdrojové tabulky a ID rozsahu, které se mají odstranit. Měla by vrátit sadu záznamů se sloupci s názvy ExtentId a TableName.

Vypustit konkrétní nebo více rozsahů

.dropextents(ExtentIds (Id rozsahu))fromTablename

Parametry

Název	Typ	Vyžadováno	Popis
ExtentIds (Id rozsahu)	guid	✔️	Jeden nebo více jedinečných identifikátorů oddělených čárkami rozsahů, které se mají vynechat.
TableName	string		Název tabulky, ve které se nachází rozsah, který se má vynechat.

Přetažení rozsahů podle zadaných vlastností

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

Parametry

Název	Typ	Vyžadováno	Popis
N	int	✔️	Rozsahy poklesu starší než N dnů/hodin.
TableName	string		Název tabulky, ve které se nachází rozsah, který se má vynechat
Velikost	int	✔️	Upravte data v databázi tak, aby součet rozsahů odpovídal požadované velikosti (MaxSize).
LimitCount	int	✔️	Používá se pro první rozsahy LimitCount .

Příkaz podporuje režim emulace, který vytvoří výstup, jako by se příkaz spustil, ale bez jeho skutečného spuštění. Použijte .drop-pretend místo ..drop

Návraty

Příkaz vrátí tabulku s následujícími informacemi.

Výstupní parametr	Typ	Description
Id rozsahu	string	ExtentId, který byl vyřazen z důvodu příkazu
TableName	string	Název tabulky, kam rozsah patřil
Vytvořeno V	dateTime	Časové razítko obsahující informace o tom, kdy byl rozsah původně vytvořen.

Vrácená hodnota příkazu může například vypadat jako v následující tabulce.

ID rozsahu	Název tabulky	Vytvořeno
43c6e03f-1713-4ca7-a52a-5db8a4e8b87d	TestTable	2015-01-12 12:48:49.4298178

Příklady

Odstranění konkrétního rozsahu

K odstranění konkrétního rozsahu použijte ID rozsahu.

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

Vypustit více rozsahů

Pomocí seznamu ID rozsahů můžete vynechat více rozsahů.

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

Odebrat všechny rozsahy podle času vytvoření

Odebrání všech rozsahů vytvořených před více než 10 dny ze všech tabulek v databázi MyDatabase

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

Odebrání některých rozsahů podle času vytvoření

Odeberte všechny rozsahy v tabulkách Table1 , jejichž Table2 čas vytvoření byl před více než 10 dny.

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

Odebrání rozsahu pomocí extent_id()

Odebrání rozsahu z tabulky pomocí předdefinované extent_id() funkce

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

Režim emulace: Zobrazení rozsahů, které by příkaz odebral

Poznámka

Parametr ID rozsahu není pro tento příkaz použitelný.

.drop-pretend extents older 10 days from all tables

Odebrání všech rozsahů z tabulky TestTable

.drop extents from TestTable

Poznámka

Odebrání všech rozsahů nemusí nutně odstranit všechna data v tabulce, pokud je povolený ingestování streamování. Pokud chcete vymazat všechna data tabulky, použijte .clear table data TestTable.