. Tag extent di rilascio.drop extent tags

Il comando viene eseguito nel contesto di un database specifico.The command runs in the context of a specific database. Elimina i tag di extent specifici da tutti gli extent o specifici del database e della tabella.It drops specific extent tags from all or specific extents in the database and table.

Nota

Le partizioni di dati sono denominate extent in kusto e tutti i comandi usano "extent" o "extents" come sinonimi.Data shards are called extents in Kusto, and all commands use "extent" or "extents" as a synonym. Per altre informazioni sugli extent, vedere Cenni preliminari sugli extent (partizionamenti dei dati).For more information on extents, see Extents (Data Shards) Overview.

Esistono due modi per specificare quali tag devono essere rimossi dagli extent:There are two ways to specify which tags should be removed from which extents:

  • Specificare in modo esplicito i tag che devono essere rimossi da tutti gli extent nella tabella specificata.Explicitly specify the tags that should be removed from all extents in the specified table.
  • Fornire una query i cui risultati specifichino gli ID extent nella tabella e per ogni extent, ovvero i tag da rimuovere.Provide a query whose results specify the extent IDs in the table, and for each extent - the tags that should be removed.

SintassiSyntax

.drop[ async ] extent tags from table TableName ( 'tag1' [ , 'Tag2' , ... , ' TagN']).drop [async] extent tags from table TableName ('Tag1'[,'Tag2',...,'TagN'])

.drop``async extent tags <| query [].drop [async] extent tags <| query

async(facoltativo): eseguire il comando in modo asincrono.async (optional): Execute the command asynchronously.

  • Viene restituito un ID operazione (Guid).An Operation ID (Guid) is returned.
  • È possibile monitorare lo stato dell'operazione.The operation's status can be monitored. Usare il comando . Show Operations .Use the .show operations command.
  • Usare il comando . Show Operation Details per recuperare i risultati di un'esecuzione corretta.Use the .show operation details command to retrieve the results of a successful execution.

RestrizioniRestrictions

Tutti gli extent devono trovarsi nel database di contesto e devono appartenere alla stessa tabella.All extents must be in the context database, and must belong to the same table.

Specificare gli extent con una querySpecify extents with a query

Gli extent e i tag da eliminare vengono specificati tramite una query kusto.The extents and the tags to drop are specified using a Kusto query. Restituisce un recordset con una colonna denominata "ExtentId" e una colonna denominata "Tags".It returns a recordset with a column called "ExtentId" and a column called "Tags".

Nota

Quando si usa la libreria client .NET di Kusto, i metodi seguenti generano il comando necessario:When using the Kusto .NET client library, the following methods will generate the required command:

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

Richiede l' autorizzazione di amministratore della tabella per tutte le tabelle di origine e di destinazione.Requires Table admin permission for all involved source and destination tables.

Sintassi per i tag extent. Drop nella querySyntax for .drop extent tags in query

.drop extent tags <| ...query...

Restituisci outputReturn output

Parametro di outputOutput parameter TypeType DescrizioneDescription
OriginalExtentIdOriginalExtentId stringstring Identificatore univoco (GUID) per l'extent originale i cui tag sono stati modificati.A unique identifier (GUID) for the original extent whose tags have been modified. L'extent viene eliminato come parte dell'operazione.The extent is dropped as part of the operation.
ResultExtentIdResultExtentId stringstring Identificatore univoco (GUID) per l'extent dei risultati con tag modificati.A unique identifier (GUID) for the result extent that has modified tags. L'extent viene creato e aggiunto come parte dell'operazione.The extent is created and added as part of the operation. In caso di errore: "non riuscito".Upon failure - "Failed".
ResultExtentTagsResultExtentTags stringstring Raccolta di tag con cui viene contrassegnato l'extent del risultato, se presente, o "null" nel caso in cui l'operazione non riesca.The collection of tags that the result extent is tagged with, if any remain, or "null" in case the operation fails.
DettagliDetails stringstring Include i dettagli dell'errore se l'operazione ha esito negativo.Includes the failure details if the operation fails.

EsempiExamples

Rilascia un tagDrop one tag

Eliminare il drop-by:Partition000 tag da qualsiasi extent nella tabella a cui è stato aggiunto il tag:Drop the drop-by:Partition000 tag from any extent in table that is tagged with it:

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

Elimina diversi tagDrop several tags

Eliminare i tag drop-by:20160810104500 , a random tag e drop-by:20160810 da qualsiasi extent nella tabella contrassegnata con uno di essi:Drop the the tags drop-by:20160810104500, a random tag, and drop-by:20160810 from any extent in table that is tagged with either of them:

.drop extent tags from table [My Table] ('drop-by:20160810104500','a random tag','drop-by:20160810')

Elimina tutti i drop-by tagDrop all drop-by tags

Elimina tutti i drop-by tag dagli extent nella tabella MyTable :Drop all drop-by tags from extents in table MyTable:

.drop extent tags <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n') 
  | mv-expand Tags to typeof(string)
  | where Tags startswith 'drop-by'

Elimina tutti i tag che corrispondono a espressioni regolari specificheDrop all tags matching specific regex

Elimina tutti i tag corrispondenti drop-by:StreamCreationTime_20160915(\d{6}) a Regex dagli extent nella tabella MyTable :Drop all tags matching regex drop-by:StreamCreationTime_20160915(\d{6}) from extents in table MyTable:

.drop extent tags <| 
  .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 esempioSample output

OriginalExtentIdOriginalExtentId ResultExtentIdResultExtentId ResultExtentTagsResultExtentTags DettagliDetails
e133f050-a1e2-4dad-8552-1f5cf47cab69e133f050-a1e2-4dad-8552-1f5cf47cab69 0d96ab2d-9dd2-4d2c-a45e-b24c65aa66870d96ab2d-9dd2-4d2c-a45e-b24c65aa6687 Partition001Partition001
cdbeb35b-87ea-499f-b545-defbae091b57cdbeb35b-87ea-499f-b545-defbae091b57 a90a303c-8a14-4207-8f35-d8ea94ca45bea90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c4fcb4598-9a31-4614-903c-0c67c286da8c 97aafea1-59ff-4312-B06B-08f42187872f97aafea1-59ff-4312-b06b-08f42187872f Partition001 Partition002Partition001 Partition002
2dfdef64-62a3-4950-a130-96b5b1083b5a2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df0fb7f3da-5e28-4f09-a000-e62eb41592df