Créer et gérer des volumes
Cet article contient des exemples de syntaxe pour la création, la gestion et la suppression de volumes Unity Catalog.
- Pour obtenir des instructions sur le chargement, la gestion ou l’utilisation de fichiers dans des volumes, consultez Gérer les fichiers dans des volumes.
- Pour plus d’informations sur l’exploration des volumes et de leur contenu, consultez Explorer le stockage et rechercher des fichiers de données.
- Pour obtenir une vue d’ensemble générale des volumes, consultez Présentation des volumes Unity Catalog.
- Pour plus d’informations sur les volumes managés et externes, consultez Volumes managés et volumes externes.
- Pour plus d’informations sur les autorisations d’Unity Catalog, consultez Présentation des privilèges pour les volumes.
Créer un volume
Quand vous créez un volume en utilisant SQL, Catalog Explorer ou d’autres outils, par défaut, c’est un volume managé qui est créé. Pour créer un volume externe, vous associez le volume à un emplacement externe.
Les instructions suivantes incluent des exemples de syntaxe pour la création de volumes managés, avec en option la spécification d’un emplacement de stockage d’objets cloud pour créer un volume externe.
Explorateur de catalogues
Pour créer un volume dans Catalog Explorer :
- Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue. - Recherchez ou accédez au schéma auquel vous souhaitez ajouter le volume, puis sélectionnez-le.
- Cliquez sur le bouton Créer un volume. (Vous devez disposer de privilèges suffisants.)
- Entrez un nom pour le volume.
- Si vous souhaitez créer un volume externe, procédez comme suit :
- Choisissez un emplacement externe dans lequel créer le volume.
- Modifiez le chemin d’accès pour refléter le sous-répertoire dans lequel vous souhaitez créer le volume.
- Fournissez un commentaire (facultatif).
- Cliquez sur Créer.
SQL
Pour créer un volume managé, utilisez la syntaxe suivante :
CREATE VOLUME <catalog>.<schema>.<volume-name>;
Pour créer un volume externe, ajoutez la clause LOCATION, comme dans l’exemple suivant :
CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 'abfss://<container-name>@<storage-account>.dfs.core.windows.net/<path>/<directory>';
Remarque
Lorsque vous définissez un volume externe, l’accès à l’URI cloud aux données sous le chemin du volume est régi par les privilèges accordés sur le volume, et non les privilèges accordés sur l’emplacement externe où le volume est stocké.
Consultez 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 |
Par défaut, les volumes managés sont créés dans l’emplacement de stockage managé associé au schéma contenant. Consultez Spécifier un emplacement de stockage managé dans Unity Catalog.
Pour créer un volume externe, 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. Consultez Se connecter au stockage d’objets cloud et aux services à l’aide du catalogue Unity.
Supprimer un volume
Explorateur de catalogues
Pour supprimer un volume dans l’Explorateur de catalogues :
- Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
- Recherchez ou accédez au volume que vous voulez supprimer et sélectionnez-le.
- Cliquez sur le
à droite du nom du volume, puis sélectionnez Supprimer. - Cliquez sur Supprimer dans la boîte de dialogue qui s’affiche pour confirmer.
SQL
Utilisez la syntaxe suivante pour supprimer un volume :
DROP VOLUME IF EXISTS <volume-name>;
Consultez DROP VOLUME.
Remarque
La suppression d’un volume managé marque les fichiers contenus pour suppression, tandis que la suppression d’un volume externe ne le fait pas. Consultez Différences de comportement entre les volumes managés et les volumes externes.
Autorisations requises
Seuls les utilisateurs disposant de privilèges de propriétaire peuvent supprimer un volume. Consultez Propriété des volumes.
Renommer un volume
Explorateur de catalogues
Pour renommer un volume dans l’Explorateur de catalogues :
- Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
- Recherchez ou accédez au volume que vous voulez renommer et sélectionnez-le.
- Cliquez sur le à droite du nom du volume, puis sélectionnez Renommer.
- Entrez un nom pour le volume.
- Cliquez sur Enregistrer.
SQL
Utilisez la syntaxe suivante pour renommer un volume :
ALTER VOLUME <volume-name> RENAME TO <new-volume-name>
Consultez ALTER VOLUME.
Autorisations requises
Seuls les utilisateurs disposant de privilèges de propriétaire peuvent renommer un volume. Consultez Propriété des volumes.
Modifier les autorisations sur un volume
Explorateur de catalogues
Pour changer les autorisations d’un volume dans l’Explorateur de catalogues, commencez par accéder à l’interface utilisateur des autorisations :
- Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
- Recherchez ou accédez au volume dont vous voulez changer les autorisations et sélectionnez-le.
- Cliquez sur l'onglet Permissions . 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 :
- Cliquez sur Octroyer.
- Tapez pour rechercher un principal. Sélectionnez le principal auquel vous souhaitez accorder des privilèges. Vous pouvez sélectionner plusieurs principaux.
- Sélectionnez les privilèges que vous souhaitez accorder.
- Cliquez sur Octroyer.
Remarque
Si le principal n’a pas les 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 d’autorisations suffisantes sur les ressources parentes pour accorder ces privilèges, une case à cocher s’affiche pour accorder ces privilèges.
Pour révoquer des privilèges, procédez comme suit :
- Sélectionnez un ou plusieurs octrois.
- Cliquez sur Révoquer.
- 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 FILES sur un volume :
GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>
La syntaxe suivante révoque WRITE FILES sur un volume :
REVOKE WRITE VOLUME ON VOLUME <volume-name> TO <principal>
Consultez Gérer les privilèges dans Unity Catalog.
Autorisations requises
Seuls les utilisateurs disposant de privilèges de propriétaire peuvent accorder des autorisations sur un volume. Consultez Propriété des volumes.
Changer le propriétaire d’un volume
Explorateur de catalogues
Pour changer le propriétaire d’un volume dans l’Explorateur de catalogues, procédez comme suit :
- Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
- Recherchez ou accédez au volume dont vous voulez changer la propriété et sélectionnez-le.
- Dans le volet À propos de ce volume, cliquez sur
en regard de Propriétaire. - Tapez pour rechercher un principal et sélectionnez-le.
- Cliquez sur Enregistrer.
SQL
Utilisez la syntaxe suivante pour changer le propriétaire d’un volume :
ALTER VOLUME <volume-name> SET OWNER TO <principal-name>
Consultez ALTER VOLUME.
Autorisations requises
Seuls les utilisateurs disposant de privilèges de propriétaire peuvent changer le propriétaire d’un volume. Consultez Propriété des volumes.