Gérer les schémas

Cet article montre comment visualiser, mettre à jour et supprimer des schémas dans Unity Catalog.

Consultez également Qu’est-ce que les schémas dans Azure Databricks ? et Créer des schémas.

Avant de commencer

Pour utiliser des schémas dans le catalogue Unity :

• Vous devez disposer d’un metastore Unity Catalog lié à l’espace de travail où vous effectuez la création du schéma.
• Le cluster que vous utilisez pour exécuter un notebook afin de gérer un schéma 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 pour modifier, afficher et supprimer des schémas dans le catalogue Unity sont répertoriées dans les sections suivantes.

Rechercher et afficher des schémas

Dans Unity Catalog, les utilisateurs peuvent voir tous les schémas pour lesquels l’autorisation USE SCHEMA leur a été attribuée, ainsi que l’autorisation USE CATALOG sur le catalogue parent du schéma. Pour accéder ou répertorier une table ou une vue dans un schéma, les utilisateurs doivent également disposer de l’autorisation SELECT sur la table ou la vue.

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 qui contient le schéma (hive_metastore s’il se trouve dans le metastore Hive).

Vous pouvez également rechercher le schéma à l’aide du champ Tapez pour filtrer dans le volet Catalogue.

SQL

Exécutez SHOW SCHEMAS dans un notebook ou dans l’éditeur de requête SQL pour lister tous les schémas d’un catalogue ou ceux qui correspondent à une expression régulière. Exécutez DESCRIBE SCHEMA pour obtenir des détails sur un schéma. Consultez AFFICHER LES SCHÉMAS et DÉCRIRE UN SCHÉMA.

Mettre à jour un schéma

Pour mettre à jour (ou modifier) un schéma dans un catalogue d’Unity Catalog, vous pouvez utiliser Catalog Explorer ou une commande SQL.

Autorisations requises : les autorisations requises pour mettre à jour un schéma dans Unity Catalog dépendent de la mise à jour :

• Pour changer le propriétaire, vous devez être le propriétaire.
• Pour renommer le schéma, vous devez en être le propriétaire.
• Pour ajouter ou mettre à jour un commentaire ou des étiquettes, vous devez être le propriétaire, ou avoir les autorisations USE SCHEMA et MODIFY sur le schéma et USE CATALOG sur le catalogue parent.
• Pour ajouter une table, vous devez être le propriétaire du schéma ou avoir les autorisations USE SCHEMA et CREATE TABLE sur le schéma et USE CATALOG sur le catalogue parent.
• Pour ajouter un schéma, vous devez être le propriétaire du schéma ou avoir les autorisations USE SCHEMA et CREATE VOLUME sur le schéma et USE CATALOG sur le catalogue parent.
• Pour accorder et révoquer des autorisations sur le schéma, vous devez être le propriétaire du schéma, le propriétaire du catalogue parent ou un administrateur de metastore.

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 qui contient le schéma, puis cliquez sur le schéma pour ouvrir la page des détails du schéma.

   Vous pouvez également rechercher le schéma à l’aide du champ Tapez pour filtrer dans le volet Catalogue.

4. Utilisez les éléments suivants de la page des détails du schéma pour mettre à jour le schéma :

   • 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é des objets 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 schéma. Consultez Gérer les privilèges dans Unity Catalog.
   • Le menu kebab : Renommer le schéma.
   • Bouton Créer : créez une table ou un volume dans le schéma. Consultez Créer ou modifier une table en utilisant le chargement de fichiers et Que sont les volumes Unity Catalog ?.

SQL

• Pour changer le propriétaire, ajouter ou mettre à jour des étiquettes, régler les propriétés du schéma et gérer l’optimisation prédictive sur les tables d’un schéma, exécutez la commande ALTER SCHEMA dans un notebook ou dans l’éditeur de requête SQL. Consultez MODIFIER UN SCHÉMA.
• Pour accorder ou révoquer des privilèges, utilisez la commande GRANT ou REVOKE. Consultez ACCORDER et RÉVOQUER.
• Pour ajouter des tables, des volumes et d’autres ressources d’IA et de données à un schéma, consultez la documentation relative à la création de la ressource (par exemple, Qu’est-ce qu’une table ? ou Gérer le cycle de vie du modèle dans Unity Catalog).
• Pour renommer un schéma en utilisant SQL, vous devez créer un nouveau schéma et y déplacer toutes les ressources.

Supprimer un schéma

Pour supprimer (ou exclure) un schéma d’un catalogue d’Unity Catalog, vous pouvez utiliser Catalog Explorer ou une commande SQL.

Autorisations requises : pour supprimer un schéma dans le catalogue Unity, vous devez être son propriétaire.

Explorateur de catalogues

Vous devez supprimer toutes les tables du schéma avant de pouvoir le supprimer.

1. Connectez-vous à un espace de travail lié au metastore.
2. Cliquez sur Catalogue.
3. Dans le volet Catalogue, sur la gauche, cliquez sur le schéma que vous souhaitez supprimer.
4. Dans le volet de détail, cliquez sur le menu en forme de kebab dans le coin supérieur droit et sélectionnez Supprimer.
5. Dans la boîte de dialogue Supprimer un schéma, cliquez sur Supprimer.

SQL

Exécutez la commande SQL suivante dans un notebook ou dans l’Éditeur de requête SQL. Les éléments entre chevrons sont optionnels. Remplacez l’espace réservé <schema-name>.

Pour obtenir les descriptions des paramètres, consultez DROP SCHEMA.

Si vous utilisez DROP SCHEMA sans l’option CASCADE, vous devez supprimer toutes les tables du schéma avant de pouvoir le supprimer.

DROP SCHEMA [ IF EXISTS ] <schema-name> [ RESTRICT | CASCADE ]

Par exemple, pour supprimer un schéma nommé inventory_schema et ses tables :

DROP SCHEMA inventory_schema CASCADE

Étapes suivantes

Pour découvrir comment ajouter des tables et des volumes à votre schéma, consultez Qu’est-ce qu’une table ? et Que sont les volumes Unity Catalog ?.