Groupes de commandes configure
Remarque
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 groupe de commandes configure dans la CLI Databricks vous permet d'authentifier la CLI Databricks avec Azure Databricks à l'aide de jetons d'accès personnels Azure Databricks ou de jetons Microsoft Entra ID (anciennement Azure Active Directory).
Remarque
En guise de bonne pratique de sécurité, quand vous vous authentifiez avec des outils, systèmes, scripts et applications automatisés, Databricks recommande d’utiliser des jetons d’accès personnels appartenant à des principaux de service et non des utilisateurs de l’espace de travail. Pour créer des jetons d’accès pour des principaux de service, consultez la section Gérer les jetons pour un principal de service.
Notez que cet article couvre uniquement le jeton d’accès personnel Azure Databricks et l’authentification par jeton Microsoft Entra ID pour permettre l’appel de commandes au niveau de l’espace de travail. Pour obtenir des options de configuration d’authentification supplémentaires, consultez Authentification pour l’interface CLI Databricks.
Important
Avant d'exécuter cette commande, assurez-vous de configurer la CLI Databricks.
Vous exécutez les commandes configure en les ajoutant à databricks configure. Pour afficher l'aide sur la commande configure, exécutez databricks configure -h.
Créer un profil de configuration
Un profil de configuration est un ensemble de paramètres contenant des informations d'authentification telles qu'une URL d'espace de travail Azure Databricks et une valeur de jeton d'accès. Un profil de configuration a un nom de programme, tel que DEFAULT, DEV, ou PROD.
Pour créer un profil de configuration, exécutez la commande configure comme suit :
databricks configure --host <workspace-url>
Pour <workspace-url>, saisissez l'URL de votre espace de travail, au format https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Pour obtenir l’URL de l’espace de travail, consultez URL d’espace de travail.
La commande vous invite à saisir votre jeton d'accès personnel Azure Databricks ou votre jeton Microsoft Entra ID (anciennement Azure Active Directory) qui correspond à l’<workspace-url> spécifié :
✔ Databricks Token:
Après avoir saisi votre jeton d'accès, votre jeton d'accès est stocké dans le fichier ~/.databrickscfg sous Linux ou macOS, ou %USERPROFILE%\.databrickscfg sous Windows par défaut. Le fichier contient une entrée de profil de connexion par défaut nommée DEFAULT :
[DEFAULT]
host = <workspace-url>
token = <access-token>
Pour utiliser un nom différent pour votre profil de connexion au lieu de DEFAULT, ajoutez l'option --profile à la commande configure, par exemple :
databricks configure --host <workspace-url> --profile <profile-name>
Conseil
Vous pouvez appuyer sur Tab après --profile ou -p pour afficher une liste de profils de configuration disponibles existants à choisir, au lieu d’entrer manuellement le nom du profil de configuration.
Toutes les informations d'hôte et de jeton existantes dans le profil de connexion spécifié sont remplacées par les nouvelles informations d'hôte et de jeton.
L'ajout de plusieurs profils de connexion au fichier .databrickscfg vous permet d'exécuter rapidement des commandes dans différents espaces de travail en spécifiant le nom du profil de connexion cible dans l'option de la commande --profile. Si vous ne spécifiez pas l'option --profile dans une commande prenant en charge cette option, la commande DEFAULT utilisera le profil de connexion par défaut.
Par exemple, vous pouvez avoir un profil de connexion 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 connexion distinct nommé profil de connexion PROD qui fait référence à un autre espace de travail Azure Databricks que vous utilisez pour les charges de travail de production.
Vous pouvez modifier le chemin par défaut de ce fichier .databrickscfg en définissant la variable d'environnement DATABRICKS_CONFIG_FILE. Pour savoir comment définir les variables d’environnement, consultez la documentation de votre système d’exploitation.
Pour obtenir des informations sur les profils de configuration existants, utilisez la commande auth group.