Příkaz rozsahů .drop

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

Tento příkaz má několik variant: V jednom se rozsahy vyřazení zadají dotazem Kusto. V ostatních variantách jsou rozsahy specifikovány pomocí minijazyčného jazyka popsaného níže.

Poznámka:

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

Upozornění

Pokud rozsah odstraní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 TableName, musíte mít alespoň oprávnění správce tabulky ke spuštění příkazu.

Pokud není zadaný název TableName, musíte mít alespoň oprávnění správce databáze ke spuštění příkazu.

Syntaxe

Odstranění rozsahů pomocí dotazu

.dropextents [whatif] <| Dotaz

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

Parametry

Název	Type	Požadováno	Popis
whatif	string		Pokud je zadáno, budou rozsahy hlášeny místo vyřazení.
Dotaz	string	✔️	Výsledky tohoto dotazu dotazovací jazyk Kusto (KQL) určují zdrojové tabulky a ID rozsahu, které se mají vynechat. Měla by vrátit sadu záznamů se sloupci s názvem ExtentId a TableName.

Zahoďte konkrétní nebo více rozsahů.

.dropextents (ExtentIds) from TableName

Parametry

Název	Type	Požadováno	Popis
ExtentIds	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 vyřazení.

Rozsahy přetažení podle zadaných vlastností

.dropextents [older N (days | hours)] from (TableName | tablesall) [trim by (extentsize | datasize) Size (MB | bytes | GB)] [limit LimitCount]

Parametry

Název	Type	Požadováno	Popis
N	int	✔️	Rozsahy poklesu starší než N dnů/hodin.
TableName	string		Název tabulky, ve které se nachází rozsah vyřazení
Velikost	int	✔️	Oříznout data v databázi, dokud součet rozsahů neodpovídá požadované velikosti (MaxSize).
LimitCount	int	✔️	Použije se na první rozsahy LimitCount .

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

Návraty

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

Výstupní parametr	Typ	Popis
ExtentId	string	ExtentId, který byl vyřazen z důvodu příkazu
TableName	string	Název tabulky, kde rozsah patří
CreatedOn	dateTime	Časové razítko, které obsahuje informace o tom, kdy byl rozsah původně vytvořen

Například návratová hodnota příkazu může vypadat jako v následující tabulce.

ID rozsahu	Název tabulky	Vytvořeno dne
43c6e03f-1713-4ca7-a52a-5db8a4e8b87d	Testovací tabulka	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

Zahoďte více rozsahů.

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

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

Odebrání všech rozsahů podle času vytvořeného

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ého

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

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

Odebrání rozsahu pomocí extent_id()

Odeberte rozsah z tabulky pomocí integrované extent_id() funkce.

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

Režim emulace: Umožňuje zobrazit rozsahy, 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 testovací tabulky

.drop extents from TestTable

Poznámka:

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