Aller au contenu principal
Dernière mise à jour le

Didacticiel CLI Databricks

remarque

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.

L'utilitaire d'interface de ligne de commande Databricks (également appelé Databricks CLI) fournit une interface facile à utiliser pour automatiser la plateforme Databricks depuis votre terminal, invite de commande ou scripts d'automatisation. Voir Databricks CLI.

Cet article explique comment installer et configurer rapidement le Databricks CLI.

Confirmer les exigences de la machine locale​

Ce didacticiel suppose que :

  • Pour Linux ou macOS, vous avez Homebrew installé.
remarque

Pour d'autres façons d'installer la CLI si vous ne pouvez pas utiliser Homebrew, consultez Installer ou mettre à jour la CLI Databricks.

remarque

L'installation de la CLI Databricks avec Chocolatey est expérimentale. Pour connaître d'autres façons d'installer la CLI, consultez Installer ou mettre à jour la CLI Databricks.

Installez la CLI Databricks​

  1. Installez la CLI Databricks:

Utilisez Homebrew pour installer la CLI Databricks en exécutant les commandes suivantes :

Bash
brew tap databricks/tap
brew trust databricks/tap
brew install databricks

La commande brew trust est requise à partir de Homebrew 6.0.0.

  1. Confirmez que le CLI Databricks est installé en exécutant la commande suivante, qui affiche la version actuelle du CLI Databricks installé. Cette version doit être 0,205,0 ou supérieure :

    Bash
    databricks -v

Configurer l'accès à votre workspace​

Ensuite, configurez l'accès à votre workspace Databricks.

remarque

Ce tutoriel utilise l'authentification OAuth user-to-machine (U2M) pour authentifier la CLI à l'aide de votre compte utilisateur Databricks. Pour configurer la CLI afin d'utiliser d'autres types d'authentification Databricks, consultez Authentification pour la CLI Databricks.

  1. Utilisez la CLI Databricks pour initier localement la gestion des jetons OAuth en exécutant la commande suivante pour chaque compte ou workspace cible.

    Pour les Opérations au niveau du compte, dans la commande suivante, remplacez les espaces réservés suivants :

    Bash
    databricks auth login --host <account-console-url> --account-id <account-id>

    Pour les opérations au niveau du workspace, dans la commande suivante, remplacez <workspace-url> par l'URL de votre instance de workspace Databricks, par https://dbc-a1b2345c-d6e7.cloud.databricks.com exemple.

    Bash
    databricks auth login --host <workspace-url>

  2. La CLI Databricks vous invite à enregistrer les informations que vous avez saisies en tant que profil de configuration Databricks. Appuyez sur Enter pour accepter le nom de profil suggéré, ou entrez le nom d’un profil nouveau ou existant. Tout profil existant portant le même nom est écrasé avec les informations que vous avez saisies. Vous pouvez utiliser des profils pour basculer rapidement votre contexte d'authentification entre plusieurs comptes ou workspaces.

    Pour obtenir une liste de tous les profils existants, dans un terminal ou une invite de commande distinct, utilisez la CLI Databricks pour exécuter la commande databricks auth profiles. Pour consulter les paramètres existants d’un profil spécifique, exécutez la commande databricks auth env --profile <profile-name>.

  3. Dans votre navigateur web, suivez les instructions à l'écran pour vous connecter à votre compte ou Workspace Databricks.

  4. Pour afficher la valeur actuelle du token OAuth d'un profil et le timestamp d'expiration à venir du token, exécutez l'une des commandes suivantes :

    Pour les opérations au niveau du compte, exécutez les commandes suivantes :

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Si vous avez plusieurs profils avec les mêmes valeurs --host et --account-id, vous devrez peut-être spécifier les options --host, --account-id et -p ensemble pour aider l’interface CLI Databricks à trouver les informations de jeton OAuth correspondantes.

    Pour les Workspace-level Opérations, exécutez les commandes suivantes :

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Si vous avez plusieurs profils avec les mêmes valeurs --host, vous pourriez avoir besoin de spécifier les options --host et -p ensemble pour aider la CLI Databricks à trouver les informations de jeton OAuth correspondantes.

Étapes suivantes​

Sur cette page