Gérer les schémas

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

Voir aussi Qu'est-ce qu'un schéma dans Databricks ? et Créer des schémas.

remarque

Dans Hive metastore, vous devez utiliser des commandes SQL pour gérer les schémas. Le comportement du Hive metastore hérité diffère de celui d'Unity Catalog. Les autorisations requises dépendent de l'utilisation ou non du contrôle d'accès aux tables. Voir Schémas dans Hive metastore et Privilèges et objets sécurisables de Hive metastore (hérités).

Avant de commencer

Pour travailler avec les schémas dans Unity Catalog :

• Vous devez disposer d'un métastore Unity Catalog lié au Workspace 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 compatible avec Unity Catalog. Voir Modes d'accès. Les SQL Warehouse prennent toujours en charge Unity Catalog.
• Les autorisations requises pour modifier, afficher et supprimer des schémas dans Unity Catalog sont listées dans les sections suivantes.

Rechercher et afficher les schémas

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

Catalog Explorer

1. Connectez-vous à un Workspace lié au metastore Unity Catalog.
2. Cliquez sur le Catalogue .
3. Dans le volet Catalog à gauche, cliquez sur le catalogue qui contient le schéma (hive_metastore s’il se trouve dans le Hive metastore).

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

SQL

Exécutez SHOW SCHEMAS dans un notebook ou l’éditeur de requêtes 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 SHOW SCHEMAS et DESCRIBE SCHEMA.

Mettre à jour un schéma

Pour mettre à jour (ou modifier) un schéma dans un catalogue 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 ou disposer de MANAGE et USE SCHEMA sur le schéma, et de USE CATALOG sur le catalogue parent.
• Pour renommer le schéma, vous devez être le propriétaire ou avoir MANAGE et USE SCHEMA sur le schéma, et USE CATALOG et CREATE SCHEMA sur le catalogue parent.
• Pour ajouter ou mettre à jour un commentaire, vous devez être le propriétaire ou disposer de USE SCHEMA et MANAGE sur le schéma et de USE CATALOG sur le catalogue parent.
• Pour ajouter ou mettre à jour des tags, vous devez être le propriétaire ou avoir USE SCHEMA et APPLY_TAG 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 disposer de USE SCHEMA et CREATE TABLE sur le schéma et de USE CATALOG sur le catalogue parent.
• Pour ajouter un volume, vous devez être le propriétaire du schéma ou avoir 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, un administrateur du metastore, ou avoir MANAGE et USE SCHEMA sur le schéma et USE CATALOG sur le catalogue parent.

Catalog Explorer

1. Connectez-vous à un Workspace lié au metastore Unity Catalog.

2. Cliquez sur le Catalogue .

3. Dans le volet Catalogue sur la gauche, cliquez sur le catalogue qui contient le schéma, puis cliquez sur le schéma pour ouvrir la page de détails du schéma.

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

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

   • 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 Permissions : accordez et révoquez 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. Voir Créer ou modifier une table à l'aide d'un upload de fichier et Que sont les volumes Unity Catalog ?.

SQL

• Pour modifier le propriétaire, ajouter ou mettre à jour des balises, définir les propriétés de 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 l'éditeur de query SQL. See ALTER SCHEMA.
• Pour accorder ou révoquer des privilèges, utilisez la commande GRANT ou REVOKE. See GRANT and REVOKE.
• Pour ajouter des tables, des volumes et d'autres assets de données et d'IA à un schéma, consultez la documentation pour la création de l'asset (par exemple tables Databricks ou Gérer le cycle de vie des modèles dans Unity Catalog).
• Pour renommer un schéma à l'aide de SQL, vous devez créer un nouveau schéma et déplacer tous les assets vers le nouveau schéma.

Supprimer un schéma

Pour supprimer (ou annuler) un schéma dans un catalogue Unity Catalog, vous pouvez utiliser l’Explorateur de catalogues ou une commande SQL.

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

**Autorisations requises** : Pour supprimer un schéma dans Unity Catalog, vous devez en être le propriétaire.

Catalog Explorer

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

1. Connectez-vous à un Workspace lié au métastore.
2. Cliquez sur le Catalogue .
3. Dans le volet **Catalog**, à gauche, cliquez sur le schéma que vous souhaitez supprimer.
4. Dans le volet de détails, cliquez sur le menu kebab dans le coin supérieur droit et sélectionnez Supprimer .
5. Dans la boîte de dialogue Supprimer le schéma , cliquez sur Supprimer .

SQL

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

Pour 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.

SQL

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

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

SQL

DROP SCHEMA inventory_schema CASCADE

Étapes suivantes

Pour savoir comment ajouter des tables et des volumes à votre schéma, consultez les tables Databricks et Que sont les volumes Unity Catalog ?.