Tag extent della tabella .drop
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
] table
Tag TableNameextent
tags
(
[,
...])
with
(
extentCreatedOnFrom
=
FromDate,
extentCreatedOnTo
=
Todate)
.drop
[async
] table
Query TableNameextent
=
with
tags
(
extentCreatedOnFrom
FromDate,
=
extentCreatedOnTo
ToDate )
<|
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
- Lo stato dell'operazione può essere monitorato con il GUID. Usare il comando
.show operations
. - Usare il
.show operation details
comando per recuperare i risultati di un'esecuzione riuscita.
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 tag
e 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 |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Invia e visualizza il feedback per