volumes groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le volumes groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les volumes dans le catalogue Unity. Les volumes fournissent des fonctionnalités permettant d’accéder, de stocker, de régir, d’organiser et de traiter des fichiers. Découvrez quels sont les volumes du catalogue Unity ?.

création de volumes databricks

Créez un nouveau volume.

L’utilisateur peut créer un volume externe ou un volume managé. Un volume externe est créé à l’emplacement externe spécifié, tandis qu’un volume managé se trouve à l’emplacement par défaut spécifié par le schéma parent, ou le catalogue parent, ou le metastore.

Pour que la création du volume réussisse, l’utilisateur doit remplir les conditions suivantes :

• L’appelant doit être un administrateur de metastore, ou être le propriétaire du catalogue parent et du schéma, ou avoir le USE_CATALOG privilège sur le catalogue parent et le USE_SCHEMA privilège sur le schéma parent.
• L’appelant doit avoir le privilège CREATE VOLUME sur le schéma parent.

Pour un volume externe, les conditions suivantes doivent également être satisfaites :

• L’appelant doit avoir le privilège CREATE EXTERNAL VOLUME sur l’emplacement externe.
• Il n’existe pas d’autres tables, ni d'autres volumes dans l’emplacement de stockage spécifié. - L’emplacement de stockage spécifié n’est pas sous l’emplacement d’autres tables, ni volumes, catalogues ou schémas.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Le nom du catalogue où se trouvent le schéma et le volume.

SCHEMA_NAME

    Nom du schéma dans lequel est le volume

NAME

    Nom du volume

VOLUME_TYPE

    Type du volume. Un volume externe se trouve dans l'emplacement externe spécifié. Un volume managé se trouve à l’emplacement par défaut spécifié par le schéma parent, ou le catalogue parent, ou le metastore. Consultez Les volumes managés et externes. Valeurs prises en charge : EXTERNAL, MANAGED

Options

--comment string

    Commentaire attaché au volume.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--storage-location string

    Emplacement de stockage sur le cloud.

Indicateurs globaux

Examples

L’exemple suivant crée un volume managé :

databricks volumes create my_catalog my_schema my_volume MANAGED

L’exemple suivant crée un volume externe avec un commentaire :

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

suppression des volumes databricks

Supprime un volume du catalogue parent et du schéma parent indiqués.

L’appelant doit être un administrateur de metastore ou un propriétaire du volume. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

databricks volumes delete NAME [flags]

Arguments

NAME

    Le nom qualifié complet (en trois niveaux) du volume

Options

Indicateurs globaux

Examples

L’exemple suivant supprime un volume :

databricks volumes delete my_catalog.my_schema.my_volume

liste des volumes databricks

Liste les volumes du metastore actuel, sous le catalogue et schéma parent spécifiés.

Les volumes retournés sont filtrés en fonction des privilèges de l’utilisateur appelant. Par exemple, l’administrateur du metastore peut répertorier tous les volumes. Un utilisateur régulier doit être le propriétaire ou avoir les READ VOLUME privilèges sur le volume pour que les volumes soient inclus dans la réponse. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Identificateur du catalogue

SCHEMA_NAME

    Identificateur du schéma

Options

--include-browse

    Indique s’il faut inclure dans la réponse les volumes pour lesquels le principal n’a accès qu’à certaines métadonnées sélectionnées.

--max-results int

    Nombre maximal de volumes à retourner (longueur de page).

--page-token string

    Jeton opaque retourné par une requête précédente.

Indicateurs globaux

Examples

L’exemple suivant répertorie tous les volumes d’un catalogue et d’un schéma :

databricks volumes list my_catalog my_schema

lecture des volumes databricks

Obtenir un volume du metastore pour un catalogue et un schéma spécifiques.

L'appelant doit être administrateur de metastore, propriétaire du volume, ou disposer du privilège READ VOLUME sur ce volume. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

databricks volumes read NAME [flags]

Arguments

NAME

    Le nom qualifié complet (en trois niveaux) du volume

Options

--include-browse

    Indique s’il faut inclure dans la réponse les volumes pour lesquels le principal n’a accès qu’à certaines métadonnées sélectionnées.

Indicateurs globaux

Examples

L’exemple suivant obtient des informations sur un volume :

databricks volumes read my_catalog.my_schema.my_volume

L’exemple suivant obtient des informations sur le volume, notamment les métadonnées de navigation :

databricks volumes read my_catalog.my_schema.my_volume --include-browse

mise à jour des volumes databricks

Mettez à jour le volume spécifié dans le catalogue parent et le schéma spécifiés.

L’appelant doit être un administrateur de metastore ou un propriétaire du volume. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

Actuellement, seul le nom, le propriétaire ou le commentaire du volume peuvent être mis à jour.

databricks volumes update NAME [flags]

Arguments

NAME

    Le nom qualifié complet (en trois niveaux) du volume

Options

--comment string

    Commentaire attaché au volume.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--new-name string

    Nouveau nom pour le volume.

--owner string

    Identificateur de l’utilisateur propriétaire du volume.

Indicateurs globaux

Examples

L’exemple suivant met à jour le commentaire d’un volume :

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

L’exemple suivant modifie le propriétaire d’un volume :

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

L’exemple suivant renomme un volume :

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

    Nom du profil dans le ~/.databrickscfg fichier à utiliser pour exécuter la commande. Si cet indicateur n’est pas spécifié, s’il existe, le profil nommé DEFAULT est utilisé.

--progress-format format

    Format permettant d’afficher les journaux de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser