Partager via

Gérer les catalogues

  • Article

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 et objets sécurisables des catalogues Unity.

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 un catalogue étranger.

Spécifications

Pour visualiser, 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. Voir Modes d’accès aux fichiers.

    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 Icône Catalogue 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 ongletsSché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 des détails 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 changer le propriétaire, vous devez être le propriétaire.
  • Pour renommer le catalogue, vous devez être le propriétaire.
  • Pour ajouter ou mettre à jour un commentaire ou des étiquettes, vous devez être le propriétaire, ou avoir les autorisations 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 ou un administrateur de metastore.

Explorateur de catalogues

  1. Connectez-vous à un espace de travail lié au metastore Unity Catalog.
  2. Cliquez sur Icône Catalogue Catalogue.
  3. Dans le volet Catalogue à gauche, cliquez sur le catalogue que vous voulez mettre à jour.
  4. Utilisez les éléments suivants de la page des détails du catalogue pour mettre à jour le catalogue :

SQL

  • Pour changer le 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. Consultez ALTER CATALOG.
  • Pour accorder ou révoquer des privilèges, utilisez la commande GRANT ou REVOKE. Consultez 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.

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 Icône Catalogue Catalogue.
  3. Dans le volet Catalogue, à gauche, cliquez sur le catalogue à supprimer.
  4. Dans le volet de détails, cliquez sur le menu kebab menu Kebab à 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 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, 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