Commande des balises d’étendue .alter

S’applique à : ✅Azure Data Explorer

La commande s’exécute dans le contexte d’une base de données spécifique. Il modifie les balises d’étendue spécifiées de toutes les étendues retournées par la requête.

Les étendues dont les balises doivent être modifiées sont spécifiées à l’aide d’une requête Kusto qui retourne un jeu d’enregistrements avec une colonne appelée « ExtentId ».

Remarque

Les partitions de données sont appelées étendues dans Kusto, et toutes les commandes utilisent « extent » ou « extents » comme synonyme. Pour plus d’informations sur les étendues, consultez Vue d’ensemble des étendues (partitions de données).

autorisations

Vous devez disposer au moins des autorisations d’administrateur de table pour exécuter cette commande.

Syntaxe

.alter[async] table 'TableName' extent (tagsTags) ( extentCreatedOnFromwith ='FromDate' , extentCreatedOnTo='ToDate'| )<Requête

.alter-merge[async] table 'TableName' extent (tagsTags) ( extentCreatedOnFromwith ='FromDate' , extentCreatedOnTo='ToDate'| )<Requête

• .alter définit la collection des balises de l’étendue sur les balises spécifiées, tout en remplaçant les balises existantes de l’extension.
• .alter-merge définit la collection des balises de l’étendue sur l’union des balises spécifiées et des balises existantes de l’étendue.

Remarque

Pour de meilleures performances, définissez les paramètres extentCreatedOnFrom et extentCreatedOnTo sur la plus petite plage possible

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
async	string		Si elle est spécifiée, la commande s’exécute de manière asynchrone. La sortie de retour lors de l’exécution est async un ID d’opération (guid) qui peut être utilisé pour surveiller l’état de l’opération. Utilisez .show operations ou .show operation details.
Balises	string	✔️	Une ou plusieurs balises d’étendue séparées par des virgules. Chaque balise doit être placée entre guillemets simples (').
Requête	string	✔️	Spécifie les étendues dont les balises doivent être modifiées.

Restrictions

Toutes les étendues doivent se trouver dans la base de données contextuelle et doivent appartenir à la même table.

Retours

Paramètre de sortie	Type	Description
OriginalExtentId	string	Identificateur unique (GUID) pour l’étendue d’origine dont les balises ont été modifiées. L’étendue est supprimée dans le cadre de l’opération.
ResultExtentId	string	Identificateur unique (GUID) pour l’étendue de résultat qui a modifié les balises. L’étendue est créée et ajoutée dans le cadre de l’opération. En cas d’échec - « Échec ».
ResultExtentTags	string	Collection d’étiquettes avec lesquelles l’étendue de résultat est marquée ou « null » en cas d’échec de l’opération.
Détails	string	Inclut les détails de l’échec en cas d’échec de l’opération.

Exemples

Modifier les balises

Modifier les balises de toutes les étendues dans l’intervalle de temps de création spécifié dans la table MyTable pour MyTag

.alter table MyTable extent tags ('MyTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents

Modifier les balises d’étendues spécifiques

Modifier les étiquettes de toutes les étendues dans l’intervalle de temps de création spécifié dans la table MyTable, étiquetées avec et vers drop-by:MyTag drop-by:MyNewTagMyOtherNewTag

.alter table MyTable extent tags ('drop-by:MyNewTag','MyOtherNewTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents where tags has 'drop-by:MyTag'

Modifier les balises de fusion d’étendues spécifiques

Alter-merges tags of all the extents within the specified creation time range in table MyTable, tagged with drop-by:MyTag to drop-by:MyNewTag and MyOtherNewTag, by appending 2 new tags to their existing collection of tags

.alter-merge table MyTable extent tags ('drop-by:MyNewTag','MyOtherNewTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents where tags has 'drop-by:MyTag'

Exemple de sortie

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