groupe de commandesproviders
L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.
Le groupe de commandes providers au sein de la Databricks CLI contient des commandes pour gérer les fournisseurs OpenSharing. Un fournisseur de données représente l’organisation du monde réel qui partage les données. Consultez Qu'est-ce qu'OpenSharing ?
créer des fournisseurs Databricks
Créez un nouveau fournisseur d'authentification basé au minimum sur un nom et un type d'authentification. L'appelant doit être un administrateur du metastore.
databricks providers create NAME AUTHENTICATION_TYPE [flags]
Arguments
NAME
Le nom du fournisseur.
AUTHENTICATION_TYPE
Le type d'authentification OpenSharing. Valeurs prises en charge : DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN
Options
--comment string
Description du fournisseur.
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--recipient-profile-str string
Ce champ est obligatoire lorsque le authentication_type est TOKEN, OAUTH_CLIENT_CREDENTIALS ou n'est pas fourni.
Exemples
L'exemple suivant crée un fournisseur avec authentification TOKEN :
databricks providers create my_provider TOKEN --comment "My data provider" --recipient-profile-str "my_profile"
L'exemple suivant crée un fournisseur avec l'authentification DATABRICKS :
databricks providers create my_provider DATABRICKS --comment "Internal provider"
suppression des fournisseurs Databricks
Supprimer un fournisseur d'authentification si l'appelant est un administrateur du métastore ou le propriétaire du fournisseur.
databricks providers delete NAME [flags]
Arguments
NAME
Nom du fournisseur.
Options
Exemples
L'exemple suivant supprime un fournisseur :
databricks providers delete my_provider
databricks providers get
Obtenir un fournisseur d’authentification spécifique. L'appelant doit fournir le nom du fournisseur, et doit être soit un administrateur de metastore, soit le propriétaire du fournisseur.
databricks providers get NAME [flags]
Arguments
NAME
Nom du fournisseur.
Options
Exemples
L'exemple suivant obtient les détails d'un fournisseur :
databricks providers get my_provider
liste des fournisseurs Databricks
Répertorier les fournisseurs d'authentification disponibles. L'appelant doit être soit un administrateur du métastore, soit le propriétaire des fournisseurs. Les fournisseurs qui n'appartiennent pas à l'appelant ne sont pas inclus dans la réponse. Il n'y a aucune garantie d'un ordre spécifique des éléments dans le tableau.
databricks providers list [flags]
Options
--data-provider-global-metastore-id string
Si elles ne sont pas fournies, tous les fournisseurs seront retournés.
--max-results int
Nombre maximum de fournisseurs à retourner.
--page-token string
Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.
Exemples
L'exemple suivant liste tous les fournisseurs :
databricks providers list
L'exemple suivant liste les fournisseurs avec pagination :
databricks providers list --max-results 10
L'exemple suivant liste les fournisseurs pour un métastore spécifique :
databricks providers list --data-provider-global-metastore-id "my-metastore-id"
databricks providers list-provider-share-assets
Listez les assets associés au partage d'un fournisseur spécifié. L'appelant est le destinataire du partage.
databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]
Arguments
PROVIDER_NAME
Le nom du fournisseur qui détient le partage.
SHARE_NAME
Le nom du partage.
Options
--function-max-results int
Nombre maximum de fonctions à retourner.
--notebook-max-results int
Nombre maximal de Notebooks à renvoyer.
--table-max-results int
Nombre maximal de tables à retourner.
--volume-max-results int
Nombre maximal de volumes à retourner.
Exemples
L’exemple suivant liste tous les assets d’un partage de fournisseur :
databricks providers list-provider-share-assets my_provider my_share
L'exemple suivant liste les assets avec des limites sur chaque type :
databricks providers list-provider-share-assets my_provider my_share --table-max-results 5 --function-max-results 3
databricks providers list-shares
Répertorier les partages du fournisseur spécifié dans le metastore où :
- l'appelant est un administrateur de metastore,
- ou si l'appelant est le propriétaire.
databricks providers list-shares NAME [flags]
Arguments
NAME
Nom du fournisseur où lister les partages.
Options
--max-results int
Nombre maximal de partages à renvoyer.
--page-token string
Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.
Exemples
L'exemple suivant liste tous les partages pour un fournisseur :
databricks providers list-shares my_provider
L'exemple suivant liste les partages avec pagination :
databricks providers list-shares my_provider --max-results 10
Mise à jour des fournisseurs Databricks
Mettre à jour les informations d'un fournisseur d'authentification, si l'appelant est un administrateur de métastore ou le propriétaire du fournisseur. Si la mise à jour modifie le nom du fournisseur, l'appelant doit être à la fois un administrateur de métastore et le propriétaire du fournisseur.
databricks providers update NAME [flags]
Arguments
NAME
Nom du fournisseur.
Options
--comment string
Description du fournisseur.
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--new-name string
Nouveau nom pour le fournisseur.
--owner string
Nom d'utilisateur du propriétaire du fournisseur.
--recipient-profile-str string
Ce champ est obligatoire lorsque le authentication_type est TOKEN, OAUTH_CLIENT_CREDENTIALS ou n'est pas fourni.
Exemples
L'exemple suivant met à jour le commentaire d'un fournisseur :
databricks providers update my_provider --comment "Updated provider description"
L'exemple suivant met à jour le nom et le propriétaire d'un fournisseur :
databricks providers update my_provider --new-name "my_new_provider" --owner "new_owner@example.com"
Drapeaux globaux
--debug
Activer ou non la journalisation de débogage.
-h OU --help
Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.
--log-file chaîne
Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.
--log-format Format
Le type de format de log, text ou json. La valeur par default est text.
--log-level chaîne
Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.
-o, --output Type
Le type de sortie de commande, text ou json. La valeur par default est text.
-p, --profile chaîne
Nom du profil dans le fichier ~/.databrickscfg à utiliser pour exécuter la commande. Si cet indicateur n'est pas spécifié, alors s'il existe, le profil nommé DEFAULT est utilisé.
--progress-format Format
Le format pour afficher les logs de progression : default, append, inplace ou json
-t, --target chaîne
Le cas échéant, la cible de bundle à utiliser