Tag extent della tabella .drop

  • Articolo

Elimina tag extent specifici da tutti o specifici extent di una tabella. Il comando viene eseguito nel contesto di un database specifico.

Nota

Le partizioni di dati sono denominate extent e tutti i comandi usano "extent" o "extent" come sinonimo. Per altre informazioni sugli extent, vedere Panoramica degli extent (partizioni di dati).

Esistono due modi per specificare quali tag devono essere rimossi da quali extent:

  • Specificare in modo esplicito i tag che devono essere rimossi da tutti gli extent nella tabella specificata.
  • Specificare una query i cui risultati specificano gli ID extent nella tabella e, per ogni extent, i tag che devono essere rimossi.

Autorizzazioni

È necessario disporre almeno delle autorizzazioni table Amministrazione per tutte le tabelle di origine e di destinazione coinvolte.

Sintassi

.drop[async] tableTag TableNameextenttags( [, ...])with(extentCreatedOnFrom=FromDate,extentCreatedOnTo=Todate)

.drop[async] tableQuery TableNameextent=withtags(extentCreatedOnFromFromDate,=extentCreatedOnToToDate )<|

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
async string Se specificato, l'operazione viene eseguita in modo asincrono.
TableName string ✔️ Nome della tabella per cui eliminare i tag extent.
Tag string ✔️ Nomi dei tag extent da eliminare.
FromDate datetime Intervallo di date di inizio.
ToDate datetime Intervallo di date di fine.
Query string ✔️ Query di Linguaggio di query Kusto (KQL) che restituisce i tag extent da eliminare. Vedere Specificare extent con una query.

Nota

Per prestazioni migliori, impostare extentCreatedOnFrom e extentCreatedOnTo parametri sull'intervallo più piccolo possibile.

Restrizioni

Tutti gli extent devono trovarsi nel database di contesto e devono appartenere alla stessa tabella.

Restituisce

Viene restituito un ID operazione (GUID).

Suggerimento

Specificare extent con una query

Gli extent e i tag da eliminare vengono specificati usando una query Kusto. Restituisce un set di record con una colonna denominata "ExtentId" e una colonna denominata "Tags".

Nota

Quando si usa la libreria client Kusto .NET, i metodi seguenti genereranno il comando richiesto:

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

Restituire l'output

Parametro di output Tipo Descrizione
OriginalExtentId string Identificatore univoco (GUID) per l'extent originale i cui tag sono stati modificati. L'extent viene eliminato come parte dell'operazione.
ResultExtentId string Identificatore univoco (GUID) per l'extent del risultato che ha modificato i tag. L'extent viene creato e aggiunto come parte dell'operazione. In caso di errore: "Non riuscito".
ResultExtentTags string Raccolta di tag con cui viene contrassegnato l'extent del risultato, se presente o "null" nel caso in cui l'operazione non riesca.
Dettagli string Include i dettagli dell'errore se l'operazione ha esito negativo.

Esempio

Eliminare un tag

Eliminare il drop-by:Partition000 tag da qualsiasi extent nella tabella contrassegnata con esso:

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

Eliminare diversi tag

Eliminare i tag drop-by:20230312104500, a random tage drop-by:20230312 da qualsiasi extent nella tabella contrassegnata con uno di essi:

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

Eliminare tutti i drop-by tag in un intervallo di tempo di creazione specificato

Eliminare tutti i drop-by tag dagli extent nella tabella MyTable in un intervallo di tempo di creazione specificato:

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

Eliminare tutti i tag corrispondenti a espressioni regolari specifiche

Eliminare tutti i tag corrispondenti alle espressioni drop-by:StreamCreationTime_20160915(\d{6}) regolari dagli extent nella tabella 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})"

Output di esempio

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