Příkaz rozsahů .drop
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
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.