Profils de configuration pour l’interface CLI Databricks

Remarque

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.

Cet article explique comment utiliser l’interface CLI Databricks avec des profils de configuration. Il part du principe que vous avez déjà installé l’interface CLI Databricks et créé un fichier de profils de configuration Databricks. Consultez Installer ou mettre à jour l’interface CLI Databricks et Profils de configuration Azure Databricks.

Obtenir des informations sur les profils de configuration

L’ajout de plusieurs profils de configuration au .databrickscfg fichier vous permet d’exécuter rapidement des commandes sur différents espaces de travail en spécifiant le nom du profil de configuration cible dans l’indicateur --profile ou -p la commande. Si vous ne spécifiez pas de profil, l’interface CLI en sélectionne une dans l’ordre suivant :

  1. Variable DATABRICKS_CONFIG_PROFILE d’environnement, si elle est définie.
  2. Paramètre default_profile dans la [__settings__] section de .databrickscfg, le cas échéant. Vous pouvez définir ce paramètre avec databricks auth switch. Consultez databricks auth switch.
  3. Le profil DEFAULT.

Conseil

Vous pouvez appuyer sur Tab après --profile ou -p pour afficher la liste des profils de configuration disponibles existants à partir desquels choisir.

Par exemple, vous pouvez avoir un profil de configuration nommé DEV qui fait référence à un espace de travail Azure Databricks que vous utilisez pour les charges de travail de développement et un profil de configuration distinct nommé PROD qui fait référence à un autre espace de travail Azure Databricks que vous utilisez pour les charges de travail de production.

Par défaut, l’interface CLI Databricks recherche le fichier .databrickscfg dans votre dossier ~ (dossier de base d’utilisateur) sur Unix, Linux ou macOS, ou dans votre dossier %USERPROFILE% (dossier de base d’utilisateur) sur Windows. Pour modifier le chemin d’accès par défaut du fichier .databrickscfg, définissez la variable d’environnement DATABRICKS_CONFIG_FILE sur un chemin différent. Consultez les champs spécifiques à .databrickscfg.

Pour obtenir des informations sur un profil de configuration existant, exécutez la commande auth describe :

databricks auth describe --profile <configuration-profile-name>

Par exemple, voici la sortie d’un profil configuré avec l’authentification par jeton d’accès personnel Azure Databricks :

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Remarque

La commande auth env est déconseillée. Permet databricks auth describe d’inspecter la configuration d’un profil ou databricks auth token de récupérer un jeton d’accès OAuth mis en cache.

Pour obtenir des informations sur tous les profils disponibles, exécutez la commande auth profiles :

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

La sortie de la commande auth profiles n’affiche aucun jeton d’accès. Pour afficher les détails du jeton pour un profil spécifique, exécutez databricks auth describe --profile <profile-name> ou databricks auth token --profile <profile-name>.

Important

L’interface CLI Databricks ne fonctionne pas avec un fichier .netrc. Vous pouvez avoir un fichier .netrc dans votre environnement à d’autres fins, mais l’interface CLI Databricks n’utilise pas ce fichier .netrc.

Tester vos profils de configuration

Pour tester vos profils de configuration et vérifier que vous avez correctement configuré l’authentification, exécutez une commande qui se connecte à un espace de travail.

Si vous ne spécifiez pas de profil, le profil par défaut est utilisé. Par exemple, la commande suivante répertorie les versions de Databricks Runtime disponibles pour l’espace de travail Azure Databricks associé à votre profil de DEFAULT.

Remarque

Cette commande suppose que vous n’avez pas de variables d’environnement définies qui sont prioritaires sur les paramètres de votre profil DEFAULT. Pour plus d’informations, consultez la section Ordre d’évaluation de l’authentification.

databricks clusters spark-versions

Pour vérifier un profil de configuration spécifique, indiquez le nom du profil à l’aide de l’indicateur -p.

databricks clusters spark-versions -p PROD
  • Last updated on