Créer et gérer des volumes Unity Catalog

Cette page contient des exemples de syntaxe pour la création, la gestion et la suppression de volumes Unity Catalog.

• Pour obtenir des instructions sur l'upload, la gestion ou l'utilisation de fichiers dans des volumes, voir Utiliser des fichiers dans des volumes Unity Catalog.
• Pour plus de détails sur l'exploration des volumes et de leur contenu, consultez Explorer le stockage et trouver les fichiers de données.
• Pour un aperçu général des volumes, consultez Que sont les volumes Unity Catalog ?.
• Pour plus de détails sur les volumes gérés et externes, consultez Volumes gérés ou externes.
• Pour plus de détails sur les autorisations Unity Catalog, consultez Privilèges pour les volumes Unity Catalog.

Créer un volume

Lorsque vous créez un volume à l'aide de SQL, de l'Explorateur de catalogues ou d'autres outils, un volume géré est créé par default. Pour créer un volume externe, vous associez le volume à un emplacement externe.

Les instructions suivantes incluent une syntaxe d'exemple pour la création de volumes gérés et la spécification facultative d'un emplacement de stockage d'objets cloud pour créer un volume externe.

remarque

Les chemins de volume doivent contenir uniquement des caractères ASCII standard (lettres (A–Z, a–z), chiffres (0–9) et symboles courants comme (/, _, -)).

Catalog Explorer

Pour créer un volume dans l’Explorateur de catalogue :

1. Dans votre workspace Databricks, cliquez sur Catalogue .

2. Recherchez ou parcourez le schéma auquel vous souhaitez ajouter le volume et sélectionnez-le.

3. Cliquez sur Créer > Volume . (Vous devez disposer de privilèges suffisants.)

4. Entrez un nom pour le volume.

5. Choisissez de créer un volume géré ou externe. Consultez Volumes gérés ou externes.

6. Si vous créez un volume externe, procédez comme suit :

   1. Choisissez un emplacement externe dans lequel créer le volume.
   2. Modifiez le chemin pour refléter le sous-répertoire où vous souhaitez créer le volume.

7. Cliquez sur Créer .

SQL

Pour créer un volume géré, utilisez la syntaxe suivante :

SQL

CREATE VOLUME <catalog>.<schema>.<volume-name>;

Pour créer un volume externe, ajoutez la clause LOCATION, comme dans l'exemple suivant :

SQL

CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 's3://<external-location-bucket-path>/<directory>';

remarque

Lorsque vous définissez un volume externe, l'accès URI cloud aux données sous le chemin du volume est régi par les privilèges accordés sur le volume, et non par les privilèges accordés sur l'emplacement externe où le volume est stocké.

See CREATE VOLUME.

Autorisations requises

Vous devez disposer des autorisations suivantes pour créer un volume :

Ressource	Autorisations requises
Schéma	USE SCHEMA, CREATE VOLUME
Catalogue	USE CATALOG

Ressource	Autorisations requises
Schéma	USE SCHEMA, CREATE VOLUME
Catalogue	USE CATALOG

Par default, les volumes gérés sont créés dans l’emplacement de stockage géré associé au schéma conteneur. Voir Spécifier un emplacement de stockage géré dans Unity Catalog.

Pour créer des volumes externes, vous devez également disposer du privilège CREATE EXTERNAL VOLUME pour l'emplacement externe qui gère le stockage d'objets cloud spécifié dans votre clause LOCATION. Voir Se connecter au stockage d'objets cloud à l'aide de Unity Catalog.

Supprimer un volume

Catalog Explorer

Pour supprimer un volume dans l'Explorateur de catalogue :

1. Dans votre workspace Databricks, cliquez sur Catalogue .
2. Recherchez ou parcourez le volume que vous souhaitez déposer et sélectionnez-le.
3. Cliquez sur à droite du nom du volume et sélectionnez **Supprimer**.
4. Cliquez sur Supprimer dans la boîte de dialogue qui apparaît pour confirmer.

SQL

Utilisez la syntaxe suivante pour supprimer un volume :

SQL

DROP VOLUME IF EXISTS <volume-name>;

See DROP VOLUME.

remarque

La suppression d’un volume géré marque les fichiers qu’il contient pour suppression, tandis que la suppression d’un volume externe ne le fait pas. Voir Volumes gérés ou externes. Pour plus de détails sur le cycle de vie des données, la facturation du stockage et les options de récupération, consultez Cycle de vie du stockage d'objets dans Unity Catalog.

Autorisations requises

Les utilisateurs disposant de privilèges de propriétaire ou du privilège MANAGE peuvent supprimer un volume. Voir la propriété des volumes et les privilèges MANAGE.

Renommer un volume

Catalog Explorer

Pour renommer un volume dans l'Explorateur de catalogue :

1. Dans votre workspace Databricks, cliquez sur Catalogue .
2. Recherchez ou parcourez le volume que vous souhaitez renommer et sélectionnez-le.
3. Cliquez sur l' à droite du nom du volume et sélectionnez Renommer .
4. Entrez un nom pour le volume.
5. Cliquez sur Enregistrer .

SQL

Utilisez la syntaxe suivante pour renommer un volume :

SQL

ALTER VOLUME <volume-name> RENAME TO <new-volume-name>

See ALTER VOLUME.

Autorisations requises

Pour renommer un volume, vous devez en être le propriétaire ou disposer de MANAGE sur le volume, de USE SCHEMA et CREATE VOLUME sur le schéma parent, et de USE CATALOG sur le catalogue parent. Consultez Propriété du volume et privilèges MANAGE.

Modifier les autorisations sur un volume

Catalog Explorer

Pour modifier les permissions d'un volume dans Catalog Explorer, start par naviguer vers l'interface utilisateur des permissions :

1. Dans votre workspace Databricks, cliquez sur Catalogue .
2. Recherchez ou parcourez le volume dont vous souhaitez modifier les autorisations et sélectionnez-le.
3. Cliquez sur l'onglet tab . Les privilèges accordés et hérités sur le volume sont affichés.

Pour accorder de nouveaux privilèges, procédez comme suit :

1. Cliquez sur Accorder .
2. Saisissez pour rechercher un principal. Sélectionnez le principal auquel vous souhaitez accorder des privilèges. Vous pouvez sélectionner plusieurs principaux.
3. Sélectionnez les privilèges que vous souhaitez octroyer.
4. Cliquez sur Accorder .

remarque

Si le principal ne dispose pas des privilèges USE CATALOG et USE SCHEMA sur les ressources parentes, un avertissement indique que des privilèges supplémentaires sont requis. Si vous disposez des autorisations suffisantes sur les ressources parentes pour accorder ces privilèges, une case à cocher apparaît pour accorder également ces privilèges.

Pour révoquer les privilèges, procédez comme suit :

1. Sélectionner une ou plusieurs autorisations.
2. Cliquez sur Révoquer .
3. Cliquez sur **Révoquer** dans la boîte de dialogue qui s'affiche pour confirmer.

SQL

Utilisez GRANT et REVOKE pour modifier les autorisations sur un volume.

Par exemple, la syntaxe suivante accorde READ VOLUME sur un volume :

SQL

GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>

La syntaxe suivante pour révoquer WRITE VOLUME sur un volume :

SQL

REVOKE WRITE VOLUME ON VOLUME <volume-name> TO <principal>

Consultez Gérer les privilèges dans Unity Catalog.

Autorisations requises

Les utilisateurs disposant de privilèges de propriétaire ou du privilège MANAGE peuvent gérer les autorisations d’un volume. Voir la propriété des volumes et les privilèges MANAGE.

Modifier le propriétaire du volume

Catalog Explorer

Pour modifier le propriétaire d'un volume dans l'Explorateur de catalogue, procédez comme suit :

1. Dans votre workspace Databricks, cliquez sur Catalogue .
2. Recherchez ou parcourez le volume dont vous souhaitez modifier la propriété et sélectionnez-le.
3. Dans le volet **À propos de ce volume**, cliquez sur le à côté de **Propriétaire**.
4. Tapez pour rechercher un principal et sélectionnez-le.
5. Cliquez sur Enregistrer .

SQL

Utilisez la syntaxe suivante pour modifier le propriétaire d'un volume :

SQL

ALTER VOLUME <volume-name> SET OWNER TO <principal-name>

See ALTER VOLUME.

Autorisations requises

Les utilisateurs disposant de privilèges de propriétaire ou du privilège MANAGE peuvent modifier le propriétaire d'un volume. Voir la propriété des volumes et les privilèges MANAGE.