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.
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 storage-credentials groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les informations d’identification de stockage dans le catalogue Unity. Les informations d’identification de stockage représentent un mécanisme d’authentification et d’autorisation pour accéder aux données stockées sur votre locataire cloud. Chaque information d'identification de stockage est soumise aux stratégies de contrôle d'accès du catalogue Unity qui définissent quels utilisateurs et groupes peuvent y accéder. Si un utilisateur n’a pas accès à des informations d’identification de stockage dans le catalogue Unity, la demande échoue et Unity Catalog ne tente pas de s’authentifier auprès de votre locataire cloud au nom de l’utilisateur. Veuillez consulter la section Gérer les identifiants de stockage.
databricks storage-credentials create
Créez un nouvel identifiant de stockage.
L’appelant doit être un administrateur de metastore ou avoir le CREATE_STORAGE_CREDENTIAL privilège sur le metastore.
databricks storage-credentials create NAME [flags]
Arguments
NAME
Nom d'identification. Le nom doit être unique parmi les identifiants de stockage et de service du metastore.
Options
--comment string
Commentaire associé aux informations d’identification.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--read-only
Indique si les informations d’identification sont utilisables uniquement pour les opérations de lecture.
--skip-validation
L’attribution de true à cet argument ignore la validation des informations d’identification créées.
Examples
L’Exemple suivant crée de nouveaux identifiants de stockage :
databricks storage-credentials create my-storage-credential
L’exemple suivant crée des informations d’identification de stockage avec un commentaire :
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
L’exemple suivant crée des informations d’identification de stockage en lecture seule :
databricks storage-credentials create my-storage-credential --read-only
databricks storage-credentials delete
Supprimer un identifiant de stockage du metastore. L'appelant doit être propriétaire de l'identifiant de stockage.
databricks storage-credentials delete NAME [flags]
Arguments
NAME
Nom de l’information d’identification de stockage.
Options
--force
Forcez une mise à jour même s’il existe des emplacements externes dépendants ou des tables externes (lorsque l’objectif est STORAGE) ou des services dépendants (lorsque l’objectif est SERVICE).
Examples
L’exemple suivant supprime des informations d’identification de stockage :
databricks storage-credentials delete my-storage-credential
L’exemple suivant supprime de force les identifiants de stockage :
databricks storage-credentials delete my-storage-credential --force
databricks storage-credentials get
Obtenez des identifiants de stockage depuis le metastore. L’appelant doit être un administrateur de metastore, le propriétaire des informations d’identification de stockage ou disposer d’une autorisation sur les informations d’identification de stockage.
databricks storage-credentials get NAME [flags]
Arguments
NAME
Nom de l’information d’identification de stockage.
Options
Examples
L’exemple suivant obtient des informations sur un identifiant de stockage :
databricks storage-credentials get my-storage-credential
databricks storage-credentials list
Répertorier les identifiants de stockage. La liste est limitée uniquement aux informations d’identification de stockage que l’appelant a l’autorisation d’accéder. Si l’appelant est un administrateur de metastore, la récupération des informations d’identification n’est pas restreinte. Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.
databricks storage-credentials list [flags]
Options
--max-results int
Nombre maximal d’informations d’identification de stockage à renvoyer.
--page-token string
Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.
Examples
L’exemple suivant répertorie toutes les informations d’identification de stockage :
databricks storage-credentials list
Mise à jour des identifiants de stockage Databricks
Mettez à jour un identifiant de stockage dans le metastore.
L’appelant doit être le propriétaire des informations d’identification de stockage ou d’un administrateur de metastore. Si l’appelant est un administrateur de metastore, seul le owner champ peut être modifié.
databricks storage-credentials update NAME [flags]
Arguments
NAME
Nom de l’information d’identification de stockage.
Options
--comment string
Commentaire associé aux informations d’identification.
--force
Force la mise à jour même s’il existe des emplacements externes ou des tables externes dépendant(e)s.
--isolation-mode IsolationMode
Indique si la ressource sécurisée est accessible depuis tous les espaces de travail ou uniquement depuis un ensemble spécifique. Valeurs prises en charge : [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]
--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 les informations d’identification de stockage.
--owner string
Nom d’utilisateur du propriétaire actuel des informations d’identification.
--read-only
Indique si les informations d’identification sont utilisables uniquement pour les opérations de lecture.
--skip-validation
L’attribution de true à cet argument ignore la validation des informations d’identification mises à jour.
Examples
Voici un exemple qui met à jour le commentaire d'un identifiant de stockage :
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
L’exemple suivant modifie le propriétaire d’une information d’identification de stockage :
databricks storage-credentials update my-storage-credential --owner someone@example.com
L’exemple suivant renomme les informations d’identification de stockage :
databricks storage-credentials update my-storage-credential --new-name updated-credential
databricks storage-credentials validate
Validez les informations d’identification de stockage. Au moins un de external_location_name et url doit être fourni. Si un seul d’entre eux est fourni, il sera utilisé pour la validation. Et si les deux sont fournis, le url sera utilisé pour la validation et external_location_name sera ignoré lors de la vérification des URL qui se chevauchent.
Soit les informations d’identification spécifiques à storage_credential_name, soit celles spécifiques au cloud doivent être fournies.
L’appelant doit être un administrateur de metastore ou le propriétaire des informations d’identification de stockage ou avoir le CREATE_EXTERNAL_LOCATION privilège sur le metastore et les informations d’identification de stockage.
databricks storage-credentials validate [flags]
Options
--external-location-name string
Nom d’un emplacement externe existant à valider.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--read-only
Indique si les informations d’identification de stockage sont utilisables uniquement pour les opérations de lecture.
--storage-credential-name string
Required.
--url string
URL d’emplacement externe à valider.
Examples
L’exemple suivant valide les informations d’identification de stockage sur un emplacement externe :
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
L’exemple suivant valide les informations d’identification de stockage par rapport à une URL :
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
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 d’affichage des journaux d’activité de progression : default, append, inplace ou json
-t, --target chaîne
Le cas échéant, la cible d’offre groupée à utiliser