Partager via

Tutoriel Databricks CLI

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.

L’interface de ligne de commande Databricks (également appelée interface CLI Databricks) est un utilitaire dont l’interface simple d’utilisation vous permet d’automatiser la plateforme Azure Databricks à partir de votre terminal, de l’invite de commandes ou de scripts d’automatisation. Consultez Qu’est-ce que l’interface CLI Databricks ?.

Cet article explique comment installer et configurer rapidement l’interface CLI Databricks.

Confirmer la configuration requise de l’ordinateur local

Ce tutoriel suppose que :

Installer l’interface CLI de Databricks

  1. Installez l’interface CLI Databricks :

    Linux, macOS

    Utilisez Homebrew pour installer l’interface CLI Databricks en exécutant les deux commandes suivantes :

    brew tap databricks/tap
brew install databricks

    Fenêtres

    Vous pouvez utiliser winget, Chocolatey ou WSL (Sous-système Windows pour Linux) pour installer l’interface CLI Databricks. Si vous ne pouvez pas utiliser wingetChocolatey ou WSL, vous devez ignorer cette procédure et utiliser l’invite de commande ou PowerShell pour installer l’interface CLI Databricks depuis la source à la place.

    Remarque

    L’installation de l’interface CLI Databricks avec Chocolatey est Expérimentale.

    Pour installer l’interface CLI Databricks via winget, exécutez les deux commandes suivantes, puis redémarrez votre invite de commandes :

    winget search databricks
winget install Databricks.DatabricksCLI

    Pour utiliser Chocolatey pour installer l’interface CLI Databricks, exécutez la commande suivante :

    choco install databricks-cli

    Pour utiliser WSL pour installer l’interface CLI Databricks :

    1. Installez curl et zip via WSL. Pour plus d’informations, consultez la documentation de votre système d’exploitation.

    2. Utilisez WSL pour installer l’interface CLI Databricks en exécutant la commande suivante :

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

  2. Vérifiez que l’interface CLI Databricks est installée en exécutant la commande suivante, qui affiche la version actuelle de l’interface CLI Databricks installée. Cette version doit être la version 0.205.0 ou ultérieure :

    databricks -v

configurer l’accès à votre espace de travail

Ensuite, configurez l’accès à votre espace de travail Databricks.

Remarque

Ce tutoriel utilise l’authentification utilisateur à machine OAuth (U2M) pour authentifier l’interface CLI à l’aide de votre compte d’utilisateur Azure Databricks. Pour configurer l’interface CLI afin d’utiliser d’autres types d’authentification Databricks, consultez Authentification pour l’interface CLI Databricks.

  1. Utilisez l’interface CLI Databricks pour lancer localement la gestion des jetons OAuth en exécutant la commande suivante pour chaque compte ou espace de travail cible.

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

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

    Pour les opérations au niveau de l’espace de travail, dans la commande suivante, remplacez <workspace-url> par votre URL d’espace de travail Azure Databricks, par exemple https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. L’interface CLI Databricks vous invite à enregistrer les informations que vous avez entrées en tant que profil de configuration Azure 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 remplacé par les informations que vous avez entrées. Vous pouvez utiliser des profils pour changer rapidement votre contexte d’authentification entre plusieurs comptes ou espaces de travail.

    Pour obtenir la liste des profils existants, dans un autre terminal ou une autre invite de commandes, utilisez l’interface CLI Databricks pour exécuter la commande databricks auth profiles. Pour afficher 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 à votre espace de travail Azure Databricks.

  4. Pour afficher la valeur actuelle du jeton OAuth d’un profil et l’horodatage d’expiration à venir du jeton, 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, il peut être nécessaire de spécifier les options --host, --account-id et -p ensemble pour permettre à l’interface CLI Databricks de trouver les informations du jeton OAuth correspondant.

    Pour les opérations au niveau de l’espace de travail, 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, il peut être nécessaire de spécifier les options --host et -p ensemble pour permettre à l’interface CLI Databricks de trouver les informations du jeton OAuth correspondant.

Étapes suivantes

  • Last updated on