Dela via

.drop table extent tags

  • Artikel

Släpper specifika utrymmestaggar från alla eller specifika utrymmen i en tabell. Kommandot körs i kontexten för en specifik databas.

Anteckning

Datashards kallas utrymmen och alla kommandon använder "extent" eller "extents" som en synonym. Mer information om utrymmen finns i Översikt över utrymmen (datashards).

Det finns två sätt att ange vilka taggar som ska tas bort från vilka utrymmen:

  • Ange uttryckligen de taggar som ska tas bort från alla utrymmen i den angivna tabellen.
  • Ange en fråga vars resultat anger utrymmes-ID:t i tabellen och för varje omfattning – de taggar som ska tas bort.

Behörigheter

Du måste ha minst table Admin behörigheter för alla berörda käll- och måltabeller.

Syntax

.drop[async] tableTableName-taggextenttags( [, ...])with(extentCreatedOnFrom=FromDate,extentCreatedOnTo=ToDate)

.drop[async] tableTableNameextentextentCreatedOnFromtags(=withFromDate,=extentCreatedOnToToDate)<|Query

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
async string Om åtgärden anges körs den asynkront.
TableName string ✔️ Namnet på tabellen som du vill ta bort utrymmestaggar för.
Tag string ✔️ Namnen på de utrymmestaggar som ska släppas.
FromDate datetime Startdatumintervallet.
ToDate datetime Slutdatumintervallet.
Query string ✔️ En Kusto-frågespråk fråga (KQL) som returnerar de utrymmestaggar som ska tas bort. Se Ange utrymmen med en fråga.

Anteckning

För bättre prestanda anger du extentCreatedOnFrom och extentCreatedOnTo parametrarna till det minsta möjliga intervallet.

Begränsningar

Alla utrymmen måste finnas i kontextdatabasen och måste tillhöra samma tabell.

Returer

Ett åtgärds-ID (GUID) returneras.

Tips

Ange utrymmen med en fråga

De utrymmen och taggar som ska tas bort anges med hjälp av en Kusto-fråga. Den returnerar en postuppsättning med en kolumn med namnet "ExtentId" och en kolumn med namnet "Taggar".

Anteckning

När du använder Kusto .NET-klientbiblioteket genererar följande metoder det kommando som krävs:

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

Returnera utdata

Utdataparameter Typ Description
OriginalExtentId string En unik identifierare (GUID) för den ursprungliga omfattningen vars taggar har ändrats. Omfattningen tas bort som en del av åtgärden.
ResultExtentId string En unik identifierare (GUID) för resultatmängden som har ändrat taggar. Omfattningen skapas och läggs till som en del av åtgärden. Vid fel – "Misslyckades".
ResultExtentTags string Den samling taggar som resultatmängden är taggad med, om någon finns kvar, eller "null" om åtgärden misslyckas.
Information string Innehåller information om felet om åtgärden misslyckas.

Exempel

Släpp en tagg

Ta bort taggen drop-by:Partition000 från valfri omfattning i tabellen som är taggad med den:

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

Ta bort flera taggar

Ta bort taggarna drop-by:20230312104500, a random tagoch drop-by:20230312 från alla utrymmen i tabellen som är taggade med någon av dem:

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

Ta bort alla drop-by taggar i ett angivet tidsintervall för skapande

Ta bort alla drop-by taggar från utrymmen i tabellen MyTable i ett angivet tidsintervall för skapande:

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

Ta bort alla taggar som matchar specifika regex

Ta bort alla taggar som matchar regex drop-by:StreamCreationTime_20160915(\d{6}) från utrymmen i tabellen 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})"

Exempelutdata

OriginalExtentId ResultExtentId ResultExtentTags Information
e133f050-a1e2-4dad-8552-1f5cf47cab69 0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687 Partition001
cdbeb35b-87ea-499f-b545-defbae091b57 a90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c 97aafea1-59ff-4312-b06b-08f42187872f Partition001 Partition002
2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df