Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page contient des exemples de syntaxe pour la création, la gestion et la suppression de volumes de catalogue Unity.
- Pour obtenir des instructions sur le chargement, la gestion ou l’utilisation de fichiers dans des volumes, consultez Utiliser des fichiers dans des volumes de catalogue Unity.
- 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 Managed versus external volumes.
- Pour plus d’informations sur l’autorisation du catalogue Unity, consultez Privilèges pour les volumes catalogue Unity.
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 Créer un>volume. (Vous devez disposer de privilèges suffisants.)
- Entrez un nom pour le volume.
- Choisissez s’il faut créer un volume managé ou externe. Consultez Les volumes managés et externes.
- Si vous créez 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.
- 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é.
Voir 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 à 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
à 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>;
Voir 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 Les volumes managés et externes.
Autorisations requises
Les utilisateurs disposant de privilèges de propriétaire ou du privilège MANAGE peuvent supprimer un volume. Consultez la propriété et MANAGE les privilèges du volume.
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 à 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>
Voir ALTER VOLUME.
Autorisations requises
Les utilisateurs disposant de privilèges de propriétaire ou du privilège MANAGE peuvent renommer un volume. Consultez la propriété et MANAGE les privilèges du volume.
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 VOLUME sur un volume :
GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>
La syntaxe suivante révoque WRITE VOLUME sur un volume :
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. Consultez la propriété et MANAGE les privilèges du volume.
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>
Voir 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. Consultez la propriété et MANAGE les privilèges du volume.