Gérer les catalogues

Cet article montre comment afficher, mettre à jour et supprimer des catalogues dans Unity Catalog. Un catalogue contient des schémas (bases de données), et un schéma contient des tables, des vues, des volumes, des modèles et des fonctions.

Pour plus d'informations sur les catalogues, consultez Que sont les catalogues dans Databricks ? et Créer des catalogues. Pour savoir comment octroyer et révoquer l'accès à un catalogue, consultez référence des privilèges Unity Catalog.

Pour savoir comment gérer un catalogue externe , un objet Unity Catalog qui reflète une base de données dans un système de données externe, consultez Gérer et travailler avec des catalogues externes.

Exigences

Pour afficher, mettre à jour ou supprimer un catalogue :

• Vous devez disposer d'un métastore Unity Catalog lié au Workspace où vous effectuez la tâche.

• Le cluster que vous utilisez pour exécuter un Notebook afin de gérer un catalogue doit utiliser un mode d'accès conforme à Unity Catalog. Voir les modes d'accès.

  Les SQL warehouses prennent toujours en charge Unity Catalog.

Les autorisations requises diffèrent selon la tâche et sont fournies dans chaque section suivante.

Voir les détails du catalogue

Autorisation requise : les utilisateurs peuvent consulter les métadonnées de tous les catalogues qu'ils possèdent ou sur lesquels l'autorisation USE CATALOG ou BROWSE leur a été attribuée.

remarque

Les utilisateurs disposant du privilège BROWSE sur un catalogue externe pourraient voir des métadonnées obsolètes dans Catalog Explorer ou lorsqu'ils accèdent aux métadonnées via l'API Unity Catalog. La visibilité des métadonnées dépend de la dernière exécution de REFRESH pour le catalogue étranger.

Pour afficher les informations sur un catalogue, vous pouvez utiliser l'Explorateur de catalogue ou une commande SQL.

Catalog Explorer

1. Connectez-vous à un Workspace lié au métastore.

2. Cliquez sur le Catalogue .

3. Dans le volet Catalogue , recherchez le catalogue et cliquez sur son nom.

   Certains détails sont listés en haut de la page. Les autres peuvent être consultés sur les tab Schémas , Détails , Autorisations et Workspace.

SQL

Exécutez SHOW CATALOGS dans un Notebook ou l'éditeur de query SQL pour lister tous les catalogues d'un metastore ou ceux qui correspondent à une expression régulière.

Exécutez la commande SQL suivante pour obtenir les détails d'un catalogue. Les éléments entre parenthèses sont facultatifs. Remplacez l'espace réservé <catalog-name>.

SQL

DESCRIBE CATALOG <catalog-name>;

Utilisez CATALOG EXTENDED pour obtenir tous les détails.

Pour plus d'informations, consultez DESCRIBE CATALOG.

Mettre à jour un catalogue

Pour mettre à jour (ou modifier) un catalogue, vous pouvez utiliser l’Explorateur de catalogues ou une commande SQL.

Autorisations requises : Les autorisations requises pour mettre à jour un catalogue dépendent de la mise à jour :

• Pour changer le propriétaire, vous devez être le propriétaire ou avoir MANAGE et USE CATALOG sur le catalogue.
• Pour renommer le catalogue, vous devez être le propriétaire ou avoir MANAGE et USE CATALOG sur le catalogue, et CREATE CATALOG sur le métastore parent.
• Pour ajouter ou mettre à jour un commentaire ou des tags, vous devez être le propriétaire ou disposer de MANAGE ou MODIFY et USE CATALOG sur le catalogue.
• Pour accorder et révoquer des autorisations sur le catalogue, vous devez être le propriétaire du catalogue, un administrateur de métastore, ou disposer de MANAGE et USE CATALOG sur le catalogue.

Catalog Explorer

1. Connectez-vous à un Workspace lié au metastore Unity Catalog.
2. Cliquez sur le Catalogue .
3. Dans le volet Catalogue de gauche, cliquez sur le catalogue que vous souhaitez mettre à jour.
4. Utilisez les éléments de page suivants sur la page des détails du catalogue pour mettre à jour le catalogue :
   • tab Vue d'ensemble : mettez à jour le propriétaire, ajoutez ou mettez à jour des tags, ajoutez ou mettez à jour des commentaires. Voir Gérer la propriété des objets, Appliquer des tags aux objets sécurisables de Unity Catalog, et Ajouter des commentaires aux actifs de données et d'IA.
   • tab Autorisations : accorder et révoquer les privilèges sur le catalogue. Consultez Gérer les privilèges dans Unity Catalog.
   • Le menu kebab : Renommer le catalogue.
   • Bouton Créer un schéma : ajoutez un schéma au catalogue. Consultez Créer des schémas.

SQL

• Pour modifier le propriétaire, ajouter ou mettre à jour des tags et gérer l'optimisation prédictive sur les tables d'un catalogue, exécutez la commande ALTER CATALOG dans un Notebook ou l'éditeur de query SQL. See ALTER CATALOG.
• Pour accorder ou révoquer des privilèges, utilisez la commande GRANT ou REVOKE. See GRANT and REVOKE.
• Pour ajouter des schémas au catalogue, consultez Que sont les schémas dans Databricks ?.
• Pour renommer un catalogue à l'aide de SQL, vous devez créer un nouveau catalogue et déplacer tous les assets vers le nouveau catalogue.

Supprimer un catalogue

Pour supprimer (ou "drop") un catalogue, vous pouvez utiliser Catalog Explorer ou une commande SQL.

Si le catalogue ou l'un de ses objets enfants est inclus dans un partage OpenSharing, supprimez-les du partage avant de supprimer le catalogue. Pour plus d'informations, consultez Les suppressions en cascade contournent la protection des partages.

Après avoir supprimé un catalogue, les fichiers de données des tables et des volumes gérés sont conservés pour permettre une fenêtre de récupération de 7 jours. Une fois la période de récupération terminée, les fichiers de données sont définitivement supprimés (purgés) dans les 48 heures. Les fichiers des tables externes et des volumes externes ne sont pas supprimés. Pour plus de détails sur le cycle de vie des fichiers de données, la facturation du stockage et les options de récupération, consultez le cycle de vie du stockage d'objets dans Unity Catalog.

attention

Ne supprimez pas le catalogue main, même s'il semble inutilisé. Sa suppression peut interrompre les opérations de données existantes qui en dépendent.

Autorisation requise : Propriétaire du catalogue ou MANAGE et USE CATALOG sur le catalogue.

Catalog Explorer

Vous devez supprimer tous les schémas du catalogue, sauf information_schema, avant de pouvoir supprimer un catalogue. Cela inclut le schéma default auto-créé.

1. Connectez-vous à un Workspace lié au métastore.
2. Cliquez sur le Catalogue .
3. Dans le volet Catalogue , à gauche, cliquez sur le catalogue que vous souhaitez supprimer.
4. Dans le volet de détails, cliquez sur le menu kebab à gauche du bouton Créer une base de données et sélectionnez Supprimer .
5. Dans la boîte de dialogue Supprimer le catalogue , cliquez sur Supprimer .

SQL

Exécutez la commande SQL suivante dans un Notebook ou un éditeur Databricks SQL. Les éléments entre parenthèses sont facultatifs. Remplacez l'espace réservé <catalog-name>.

Pour les descriptions des paramètres, consultez DROP CATALOG.

Si vous utilisez DROP CATALOG sans l'option CASCADE, vous devez supprimer tous les schémas du catalogue, à l'exception de information_schema, avant de pouvoir supprimer le catalogue. Cela inclut le schéma default créé automatiquement.

SQL

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Par exemple, pour supprimer un catalogue nommé vaccine et ses schémas :

SQL

DROP CATALOG vaccine CASCADE