.drop table extent tags

Verwijdert specifieke gebiedstags uit alle of specifieke gebieden van een tabel. De opdracht wordt uitgevoerd in de context van een specifieke database.

Notitie

Gegevensshards worden extents genoemd en alle opdrachten gebruiken 'extent' of 'extents' als synoniem. Zie Overzicht van gebieden (gegevensshards) voor meer informatie over gebieden.

Er zijn twee manieren om op te geven welke tags uit welke mate moeten worden verwijderd:

• Geef expliciet de tags op die moeten worden verwijderd uit alle gebieden in de opgegeven tabel.
• Geef een query op waarvan de resultaten de id's van het gebied in de tabel opgeven en voor elk gebied: de tags die moeten worden verwijderd.

Machtigingen

U moet ten minste de machtiging Tabel Beheer hebben voor alle betrokken bron- en doeltabellen.

Syntax

.drop[async] tableTableName Tagextenttags( [, ...])with(extentCreatedOnFrom=Fromdate,extentCreatedOnTo=Todate)

.drop[async] tableTableNameextent(tagsextentCreatedOnFrom=withFromDate,=extentCreatedOnToToDate-query)<|

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
async	string		Indien opgegeven, wordt de bewerking asynchroon uitgevoerd.
TableName	string	✔️	De naam van de tabel waarvoor de bereiktags moeten worden verwijderd.
Tag	string	✔️	De namen van de bereiktags die u wilt verwijderen.
Fromdate	datetime		Het begindatumbereik.
Todate	datetime		Het einddatumbereik.
Query	string	✔️	Een Kusto-querytaal -query (KQL) die de bereiktags retourneert die moeten worden verwijderd. Zie Gebieden opgeven met een query.

Notitie

Voor betere prestaties stelt u extentCreatedOnFrom de parameters en extentCreatedOnTo in op het kleinst mogelijke bereik.

Beperkingen

Alle gebieden moeten zich in de contextdatabase bevinden en moeten deel uitmaken van dezelfde tabel.

Retouren

Er wordt een bewerkings-id (GUID) geretourneerd.

Tip

• De status van de bewerking kan worden bewaakt met de GUID. Gebruik de opdracht .show operations.
• Gebruik de .show operation details opdracht om de resultaten van een geslaagde uitvoering op te halen.

Gebieden opgeven met een query

De gebieden en de tags die u wilt verwijderen, worden opgegeven met behulp van een Kusto-query. Er wordt een recordset geretourneerd met een kolom met de naam 'ExtentId' en een kolom met de naam 'Tags'.

Notitie

Wanneer u de Kusto .NET-clientbibliotheek gebruikt, wordt met de volgende methoden de vereiste opdracht gegenereerd:

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

Uitvoer retourneren

Uitvoerparameter	Type	Description
OriginalExtentId	string	Een unieke id (GUID) voor het oorspronkelijke gebied waarvan de tags zijn gewijzigd. De omvang wordt verwijderd als onderdeel van de bewerking.
ResultExtentId	string	Een unieke id (GUID) voor het resultaat dat tags heeft gewijzigd. De omvang wordt gemaakt en toegevoegd als onderdeel van de bewerking. Bij fout - 'Mislukt'.
ResultExtentTags	string	De verzameling tags waarmee het resultaat is getagd, indien aanwezig, of 'null' voor het geval de bewerking mislukt.
Details	string	Bevat de foutdetails als de bewerking mislukt.

Voorbeelden

Eén tag verwijderen

Verwijder de drop-by:Partition000 tag uit een willekeurig gebied in de tabel die ermee is gelabeld:

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

Meerdere tags verwijderen

Verwijder de tags drop-by:20230312104500, a random tagen drop-by:20230312 uit een willekeurig gebied in de tabel die met een van beide is getagd:

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

drop-by Alle tags in een opgegeven aanmaaktijdsbereik verwijderen

Verwijder alle drop-by tags uit gebieden in de tabel MyTable in een opgegeven tijdsbereik voor het maken:

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

Alle tags verwijderen die overeenkomen met specifieke regex

Verwijder alle tags die overeenkomen met regex drop-by:StreamCreationTime_20160915(\d{6}) uit gebieden in tabel 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})"

Voorbeelduitvoer

OriginalExtentId	ResultExtentId	ResultExtentTags	Details
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