Share via

Značky rozsahu tabulky .drop

  • Článek

Zahodí značky konkrétního rozsahu ze všech nebo konkrétních rozsahů tabulky. Příkaz se spouští v kontextu konkrétní databáze.

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).

Existují dva způsoby, jak určit, které značky se mají z jakého rozsahu odebrat:

  • Explicitně zadejte značky, které by měly být odebrány ze všech rozsahů v zadané tabulce.
  • Zadejte dotaz, jehož výsledky určují ID rozsahů v tabulce a pro každý rozsah značky, které by se měly odebrat.

Oprávnění

Ke všem zdrojovým a cílovým tabulkám musíte mít alespoň oprávnění Správa tabulky.

Syntax

.drop[async] tableZnačkaTableNameextenttags( [, ...])with(extentCreatedOnFrom=Datum od začátku,extentCreatedOnTo=Datum)

.drop[async] tableTableNameextentwith=(extentCreatedOnFromtagsFromDateToDate),extentCreatedOnTo=<| Query

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

Parametry

Název Typ Vyžadováno Popis
async string Pokud je zadán, operace se spustí asynchronně.
TableName string ✔️ Název tabulky, pro kterou chcete značky rozsahu odstranit.
Tag string ✔️ Názvy značek rozsahu, které se mají odstranit.
Datum od začátku datetime Rozsah počátečních dat.
Datum datetime Rozsah koncových dat.
Dotaz string ✔️ Dotaz dotazovací jazyk Kusto (KQL), který vrací značky rozsahu, které mají být vyřazeny. Viz Určení rozsahů pomocí dotazu.

Poznámka

Pro zajištění lepšího výkonu nastavte extentCreatedOnFrom parametry a extentCreatedOnTo na nejmenší možný rozsah.

Omezení

Všechny rozsahy musí být v kontextové databázi a musí patřit do stejné tabulky.

Návraty

Vrátí se ID operace (GUID).

Tip

Určení rozsahů pomocí dotazu

Rozsahy a značky, které se mají odstranit, se zadají pomocí dotazu Kusto. Vrátí sadu záznamů se sloupcem s názvem ExtentId a sloupcem s názvem "Tags".

Poznámka

Při použití klientské knihovny Kusto .NET vygenerují požadovaný příkaz následující metody:

  • CslCommandGenerator.GenerateExtentTagsDropByRegexCommand(string tableName, string regex)
  • CslCommandGenerator.GenerateExtentTagsDropBySubstringCommand(string tableName, string substring)

Vrácený výstup

Výstupní parametr Typ Description
Id původního obsahu string Jedinečný identifikátor (GUID) původního rozsahu, jehož značky byly změněny. Rozsah se v rámci operace vynechá.
ResultExtentId string Jedinečný identifikátor (GUID) pro rozsah výsledku, který má změněné značky. Rozsah se vytvoří a přidá jako součást operace. Při selhání – "Selhání".
ResultExtentTags string Kolekce značek, kterými je rozsah výsledku označený, pokud nějaké zůstávají, nebo "null" v případě selhání operace.
Podrobnosti string Zahrnuje podrobnosti o selhání, pokud operace selže.

Příklady

Odstranění jedné značky

Odstraňte drop-by:Partition000 značku z libovolného rozsahu v tabulce, která je označená:

.drop extent tags from table MyOtherTable ('drop-by:Partition000')

Odstranění několika značek

Odstraňte značky drop-by:20230312104500, a random taga drop-by:20230312 z libovolného rozsahu v tabulce, která je označená některou z nich:

.drop table [My Table] extent tags ('drop-by:20230312104500','a random tag','drop-by:20230312') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12))

Odstranění všech drop-by značek v zadaném časovém rozsahu vytváření

Odstraňte všechny drop-by značky z rozsahů v tabulce MyTable v zadaném časovém rozsahu vytvoření:

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n') 
  | mv-expand Tags to typeof(string)
  | where Tags startswith 'drop-by'

Odstranění všech značek odpovídajících konkrétnímu regulárnímu výrazu

Odstraňte všechny značky odpovídající regulárnímu výrazu drop-by:StreamCreationTime_20160915(\d{6}) z rozsahů v tabulce MyTable:

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n')
  | mv-expand Tags to typeof(string)
  | where Tags matches regex @"drop-by:StreamCreationTime_20160915(\d{6})"

Ukázkový výstup

Id původního obsahu ResultExtentId ResultExtentTags Podrobnosti
e133f050-a1e2-4dad-8552-1f5cf47cab69 0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687 Oddíl001
cdbeb35b-87ea-499f-b545-defbae091b57 a90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c 97aafea1-59ff-4312-b06b-08f42187872f Oddíl001 Oddíl002
2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df