Gérer les catalogues

Cet article montre comment visualiser, 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 Présentation des catalogues dans Azure Databricks et Créer des catalogues. Pour savoir comment accorder et révoquer l’accès à un catalogue, consultez Privilèges Unity Catalog et objets sécurisables.

Pour découvrir comment gérer un catalogue étranger, un objet Unity Catalog qui reflète une base de données dans un système de données externe, consultez Gérer et utiliser des catalogues étrangers.

Spécifications

Pour afficher, mettre à jour ou supprimer un catalogue :

• Vous devez disposer d’un metastore Unity Catalog lié à l’espace de travail 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. Consultez Modes d’accès.

  Les entrepôts SQL prennent toujours en charge Unity Catalog.

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

Consulter les détails du catalogue

Autorisation requise : les utilisateurs peuvent voir les métadonnées de tous les catalogues dont ils sont propriétaires, ou sur lesquels ils ont reçu l’autorisation USE CATALOG ou BROWSE.

Pour consulter les informations sur un catalogue, vous pouvez utiliser Catalog Explorer ou une commande SQL.

Explorateur de catalogues

1. Connectez-vous à un espace de travail lié au metastore.

2. Cliquez sur Catalogue.

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

   Certains détails sont répertoriés en haut de la page. D’autres peuvent être affichés sous les onglets Schémas, Détails, Autorisations et Espaces de travail.

SQL

Exécutez SHOW CATALOGS dans un notebook ou dans l’éditeur de requête 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 plus d’informations sur un catalogue. Les éléments entre crochets sont optionnels. Remplacez l’espace réservé <catalog-name>.

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 Catalog Explorer ou une commande SQL.

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

• Pour modifier 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 propriétaire ou avoir MANAGE et USE CATALOG sur le catalogue.
• Pour ajouter ou mettre à jour un commentaire ou des balises, vous devez être propriétaire ou avoir MANAGE ou MODIFYUSE 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 metastore ou avoir MANAGE et USE CATALOG sur le catalogue.

Explorateur de catalogues

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

SQL

• Pour changer de propriétaire, ajouter ou mettre à jour des étiquettes et gérer l’optimisation prédictive sur les tables d’un catalogue, exécutez la commande ALTER CATALOG dans un notebook ou dans l’éditeur de requête SQL. Voir ALTER CATALOG.
• Pour accorder ou révoquer des privilèges, utilisez la commande GRANT ou REVOKE. Voir GRANT et REVOKE.
• Pour ajouter des schémas au catalogue, consultez Présentation des schémas dans Azure Databricks.
• Pour renommer un catalogue en utilisant SQL, vous devez créer un nouveau catalogue et y déplacer toutes les ressources.

Supprimer un catalogue

Pour supprimer un catalogue, vous pouvez utiliser Catalog Explorer ou une commande SQL.

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

Explorateur de catalogues

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

1. Connectez-vous à un espace de travail lié au metastore.
2. Cliquez sur Catalogue.
3. Dans le volet Catalogue à gauche, cliquez sur le catalogue à supprimer.
4. Dans le volet de détails, cliquez sur à gauche du bouton Créer une base de données, puis 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 dans l’éditeur Databricks SQL. Les éléments entre crochets sont optionnels. Remplacez l’espace réservé <catalog-name>.

Pour obtenir des descriptions de paramètres, consultez DROP CATALOG.

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

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

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

DROP CATALOG vaccine CASCADE