Appliquer des étiquettes à des objets sécurisables Unity Catalog

Cet article montre comment appliquer des balises aux objets sécurisables du catalogue Unity.

Les balises sont des attributs qui incluent des clés et des valeurs facultatives que vous pouvez utiliser pour organiser et classer des objets sécurisables dans le catalogue Unity. L’utilisation d’étiquettes simplifie également la recherche et la découverte de tables et de vues à l’aide de la fonctionnalité de recherche de l’espace de travail.

Objets sécurisables pris en charge

La catégorisation des objets sécurisables est actuellement prise en charge pour les catalogues, les schémas, les tables, les colonnes de table, les volumes, les vues, les modèles enregistrés et les versions de modèle. Pour plus d'informations sur les objets sécurisables, consultez Objets sécurisables dans Unity Catalog.

Spécifications

Pour ajouter des balises à des objets sécurisables du catalogue Unity, vous devez posséder l’objet ou disposer de tous les privilèges suivants :

• APPLY TAG sur l’objet
• USE SCHEMA sur le schéma parent de l’objet
• USE CATALOG sur le catalogue parent de l’objet

Contraintes

Voici une liste de contraintes de balises :

• Vous pouvez attribuer un maximum de 20 balises à un seul objet sécurisable.
• La longueur maximale d’une clé de balise est de 255 caractères.
• La longueur maximale d’une valeur de balise est de 1 000 caractères.
• Les caractères spéciaux ne peuvent pas être utilisés dans les noms de balises.
• La recherche d’étiquettes à l’aide de l’interface utilisateur de recherche de l’espace de travail est prise en charge uniquement pour les tables, les vues et les colonnes de table.
• La recherche d’étiquettes nécessite une correspondance exacte des termes.

Ajouter et mettre à jour des balises à l’aide de l’Explorateur de catalogues

Pour ajouter et mettre à jour des balises d’objet sécurisables à l’aide de l’Explorateur de catalogues :

1. Cliquez dans la barre latérale sur Catalog.

2. Sélectionnez un objet sécurisable.

3. Sur la pageVue d’ensemble de l’objet, ajoutez ou mettez à jour une balise :

   • S’il n’y a pas de balises, cliquez sur le bouton Ajouter des balises.
   • S’il existe des balises, cliquez sur l’icône Ajouter/modifier des balises.

   Vous pouvez utiliser la boîte de dialogue Ajouter/modifier des balises pour ajouter et supprimer plusieurs balises.

   Des clés de balise sont requises. Les valeurs de balise sont facultatives.

   Pour ajouter ou modifier des balises de colonne de table, cliquez sur l’icône Ajouter une balise.

Ajouter et mettre à jour des balises à l’aide de commandes SQL

Vous pouvez utiliser la commande SQL ALTER <object> pour baliser des catalogues, des schémas, des tables (y compris les vues, les vues matérialisées et les tables de diffusion en continu), des volumes et des colonnes de table. Par exemple, vous pouvez utiliser les clauses SET TAGS et UNSET TAGS avec ALTER TABLE pour gérer les balises sur une table. Consultez lesInstructions DDL pour obtenir la liste des commandes de langage de définition de données (DDL) disponibles et leur syntaxe.

Pour les modèles inscrits, vous devez utiliser l’Explorateur de catalogues ou MLflow ClientAPI. Consultez Utiliser des balises sur les modèles.

Utiliser des étiquettes pour rechercher des tables

Vous pouvez utiliser la barre de recherche de l’espace de travail Azure Databricks pour rechercher des tables, des vues et des colonnes de table à l’aide de clés et de valeurs d’étiquettes. Vous pouvez utiliser à la fois les étiquettes de table et les étiquettes de colonne de table. Vous ne pouvez pas utiliser les étiquettes pour rechercher d’autres objets étiquetés, tels que des catalogues, des schémas ou des volumes.

Seules les tables que vous avez l’autorisation de voir apparaissent dans les résultats de la recherche. Cela signifie que vous devez disposer au moins du privilège BROWSE sur l’objet (ou sur le catalogue parent et le schéma de l’objet’) pour renvoyer l’objet dans les résultats de recherche.

Pour plus d’informations, consultez Utiliser des étiquettes pour rechercher des tables.

Récupérer des informations sur les balises depuis les tables du schéma d'information

Chaque catalogue créé dans Unity Catalog comprend un INFORMATION_SCHEMA. Ce schéma comprend des tableaux décrivant les objets connus du catalogue du schéma. Vous devez disposer des privilèges appropriés pour afficher les informations du schéma.

Vous pouvez interroger les éléments suivants pour récupérer les informations de balise :

• INFORMATION_SCHEMA.CATALOG_TAGS
• INFORMATION_SCHEMA.COLUMN_TAGS
• INFORMATION_SCHEMA.SCHEMA_TAGS
• INFORMATION_SCHEMA.TABLE_TAGS
• INFORMATION_SCHEMA.VOLUME_TAGS

Pour plus d'informations, voir Schéma d'informations.