Installer ou mettre à jour l’interface CLI Databricks

  • Article

Remarque

Ces informations s'appliquent aux versions Databricks CLI 0,205 et supérieures, qui sont en version préliminaire publique. Pour trouver votre version de l’interface CLI Databricks, exécutez databricks -v.

Cet article explique comment installer ou mettre à jour l’interface CLI Databricks. Consultez Présentation de l’interface CLI Databricks.

Installer

Installez l’interface CLI Databricks version 0.205 ou ultérieure.

L’interface CLI Databricks est également disponible à partir de l’interface utilisateur de l’espace de travail Azure Databricks. Consultez Exécuter l’interface CLI Databricks à partir d’un espace de travail Azure Databricks.

Mettre à jour

Pour mettre à jour une installation antérieure de l’interface CLI Databricks version 0.205 ou ultérieure :

Installation Homebrew pour Linux ou macOS

Pour cette option d’installation, vous utilisez Homebrew pour télécharger et installer automatiquement le fichier exécutable de l’interface CLI Databricks.

À partir de votre terminal, exécutez les deux commandes Homebrew suivantes pour installer l’interface CLI :

brew tap databricks/tap
brew install databricks

Passez ensuite à l’authentification pour l’interface CLI Databricks.

Si vous ne savez pas si Homebrew est installé ou si les commandes Homebrew précédentes échouent, suivez ces instructions plus longues :

  1. Vérifiez si Homebrew est déjà installé en exécutant la commande suivante à partir d’une invite d’interpréteur de commandes Linux ou d’un terminal macOS. Si Homebrew est installé, son numéro de version s’affiche :

    brew -v

  2. Si Homebrew n’est pas encore installé, installez-le en exécutant la commande suivante :

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    Exécutez ensuite la commande suivante pour vérifier l’installation Homebrew, qui affiche le numéro de version Homebrew :

    brew -v

  3. Utilisez Homebrew pour ajouter le référentiel databricks/homebrew-tap dans GitHub à votre liste de référentiels Homebrew Tap disponibles, en exécutant la commande suivante :

    brew tap databricks/tap

  4. Utilisez Homebrew pour indiquer au référentiel databricks/homebrew-tap de télécharger et d’installer l’exécutable de l’interface CLI Databricks, en exécutant la commande suivante :

    brew install databricks

  5. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version 0.205.0 ou un numéro supérieur est affiché, l’interface CLI Databricks est bien installée.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

  6. Passez à l’authentification pour l’interface CLI Databricks.

Installation de WinGet pour Windows

Pour cette option d’installation, vous utilisez winget pour télécharger et installer automatiquement le fichier exécutable de l’interface CLI Databricks.

  1. À partir de votre invite de commandes, exécutez les deux commandes winget suivantes pour installer l’interface CLI, puis redémarrez votre invite de commandes :

    winget search databricks
winget install Databricks.DatabricksCLI

  2. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version 0.205.0 ou un numéro supérieur est affiché, l’interface CLI Databricks est bien installée.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

  3. Passez à l’authentification pour l’interface CLI Databricks.

Installation de Chocolatey pour Windows

Remarque

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

Pour cette option d’installation, vous utilisez Chocolatey pour télécharger et installer automatiquement le dernier fichier exécutable de l’interface CLI Databricks.

  1. À partir de votre interface de ligne de commande, exécutez la commande choco suivante pour installer l’interface CLI :

    choco install databricks-cli

  2. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version 0.205.0 ou un numéro supérieur est affiché, l’interface CLI Databricks est bien installée.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

  3. Passez à l’authentification pour l’interface CLI Databricks.

installation curl pour Linux, macOS et Windows

Pour cette option d’installation, vous utilisez curl pour télécharger et installer le fichier exécutable de l’interface CLI Databricks le plus récent.

Pour Windows, Databricks vous recommande d’utiliser WSL (Sous-système Windows pour Linux). Vous devez également avoir installé unzip. Pour obtenir des instructions d’installation, consultez la documentation de votre système d’exploitation. Si vous ne pouvez pas utiliser WSL, ignorez cette procédure et utilisez à la place l’invite de commande ou PowerShell pour installer l’interface CLI Databricks depuis la source.

  1. curl doit être installé. Vous pouvez vérifier si curl est déjà installé en exécutant la commande suivante depuis une invite d’un interpréteur de commandes Linux, depuis le terminal macOS ou depuis Bash sur WSL. Si curl est installé, le numéro de version curl s’affiche :

    curl -V

  2. Si curl n’est pas encore installé, installez-le en suivant les instructions figurant sur la page des versions et téléchargementscurl en fonction de votre système d’exploitation et de votre architecture. Pour connaître l’architecture de votre ordinateur, consultez la documentation de votre système d’exploitation.

    Exécutez ensuite la commande suivante pour vérifier l’installation de curl, qui affiche le numéro de version de curl :

    curl -V

  3. Utilisez curl pour télécharger et installer la version de l’exécutable de l’interface CLI Databricks en exécutant la commande suivante (notez que vous devez spécifier les caractères majuscules et minuscules corrects pour -fsSL sur tous les systèmes d’exploitation) :

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

    Remarque

    Pour afficher le contenu du script avant de l’exécuter, consultez le fichier install.sh dans le référentiel d’installation de l’interface CLI Databricks dans GitHub.

    Pour Windows, vous devez exécuter cette commande en tant qu’administrateur.

    Pour Linux et macOS, si un message d’erreur indique que /usr/local/bin n’est pas accessible en écriture, réexécutez la commande avec sudo.

    Cette commande télécharge et installe l’exécutable de l’interface CLI Databricks dans le chemin /usr/local/bin/databricks sur macOS et Linux, et C:\Windows\databricks.exe sur Windows.

    Si, pour une raison quelconque, l’interface CLI Databricks est déjà installée, l’erreur suivante s’affiche : « Le chemin cible <path> existe déjà ». Pour résoudre ce problème, vous devez supprimer manuellement l’exécutable de l’interface CLI Databricks du chemin d’accès précédent, puis réexécuter la commande curl.

  4. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version 0.205.0 ou un numéro supérieur est affiché, l’interface CLI Databricks est bien installée.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

  5. Passez à l’authentification pour l’interface CLI Databricks.

Installation source pour Linux, macOS et Windows

Pour cette option d’installation, vous téléchargez manuellement un fichier .zip, puis extrayez manuellement l’exécutable de l’interface CLI Databricks à partir du fichier .zip téléchargé.

  1. Téléchargez sur votre ordinateur de développement local le fichier .zip de l’interface CLI Databricks le plus récent, comme indiqué dans la section Versions du référentiel de l’interface CLI Databricks dans GitHub. La dernière version a une étiquette Latest en regard de celle-ci dans la liste des versions. La dernière préversion a une étiquette Pre-release et est plus adaptée à l’expérimentation et aux utilisateurs précoces. Le fichier .zip que vous téléchargez à partir de la section Assets de la version doit correspondre au système d’exploitation et à l’architecture de votre ordinateur de développement :

    Nom de fichier Architecture
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, Intel 64 bits / x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zip macOS, Apple Silicon / M Series / arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux, Intel 64 bits / x86_64
    databricks_cli_X.Y.Z_linux_arm64.zip Linux, ARM 64 bits / arm64
    databricks_cli_X.Y.Z_windows_386.zip Windows, Intel 32 bits / x86
    databricks_cli_X.Y.Z_windows_amd64.zip Windows, Intel 64 bits / AMD64
    databricks_cli_X.Y.Z_windows_arm64.zip Windows, ARM 64 bits / ARM64

    Pour connaître l’architecture de votre ordinateur, consultez la documentation de votre système d’exploitation. Par exemple :

    • Linux : commandes de terminal uname -m, lscpuou sudo lshw -c cpu.
    • macOS : menu d’icônes Apple>À propos de ce Mac ou de la commande de terminal uname -m.
    • Windows : invite de commandes ou commande PowerShell echo %PROCESSOR_ARCHITECTURE%.

    Si vous devez vérifier l’intégrité de l’un de ces fichiers .zip, Databricks fournit un fichier de somme de contrôle nommé databricks_cli_X.Y.Z_SHA256SUMS dans la même liste que les fichiers .zip. Pour exécuter une vérification de somme de contrôle, consultez la documentation de votre système d’exploitation.

  2. Extrayez le contenu du fichier .zip téléchargé. Pour extraire le fichier .zip, consultez la documentation de votre système d’exploitation.

  3. Dans le contenu extrait, un dossier s’affiche avec le même nom que le fichier .zip. Ce dossier contient l’exécutable de l’interface CLI Databricks. Vous pouvez y laisser l’exécutable de l’interface CLI Databricks ou le copier ou le déplacer à un autre emplacement.

  4. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, à partir d’une invite d’interpréteur de commandes Linux, d’un terminal macOS ou d’une invite de commandes Windows, affichez la version du fichier exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version 0.205.0 ou un numéro supérieur est affiché, l’interface CLI Databricks est bien installée.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

    Pour macOS, vous devrez peut-être d’abord autoriser votre système à exécuter l’interface CLI Databricks. Consultez Ouvrir une application Mac provenant d’un développeur non identifié.

  5. Passez à l’authentification pour l’interface CLI Databricks.

Mise à jour Homebrew pour Linux ou macOS

Pour cette option de mise à jour, vous utilisez Homebrew pour mettre à jour automatiquement une installation précédente de l’interface CLI Databricks version 0.205 ou ultérieure vers la version la plus récente.

  1. À partir d’une invite d’interpréteur de commandes Linux ou d’un terminal macOS, utilisez Homebrew pour télécharger et mettre à jour vers la dernière version du fichier exécutable de l’interface CLI Databricks en exécutant la commande suivante :

    brew upgrade databricks

  2. Assurez-vous que l’interface CLI Databricks est correctement mise à jour. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version mis à jour attendu s’affiche, l’interface CLI Databricks est correctement installée.

    Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Versions du référentiel Interface CLI Databricks dans GitHub. La dernière version a une étiquette Latest en regard de celle-ci dans la liste des versions.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

Mise à jour WinGet pour Windows

Pour cette option de mise à jour, vous utilisez winget pour télécharger et mettre à jour automatiquement une version précédente de l’interface CLI Databricks version 0.205 ou ultérieure vers la version la plus récente.

  1. À partir de votre interface de ligne de commande, utilisez winget pour télécharger et mettre à jours vers la dernière version du fichier exécutable de l’interface CLI Databricks en exécutant la commande suivante :

    winget upgrade Databricks.DatabricksCLI

  2. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version mis à jour attendu s’affiche, l’interface CLI Databricks est correctement installée.

    Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Versions du référentiel Interface CLI Databricks dans GitHub. La dernière version a une étiquette Latest en regard de celle-ci dans la liste des versions.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

Mise à jour de Chocolatey pour Windows

Remarque

La mise à jour de l’interface CLI Databricks avec Chocolatey est Expérimentale.

Pour cette option de mise à jour, vous utilisez Chocolatey pour télécharger et mettre à jour automatiquement une version précédente de l’interface CLI Databricks version 0.205 ou ultérieure vers la version la plus récente.

  1. À partir de votre interface de ligne de commande, utilisez choco pour télécharger et mettre à jours vers la dernière version du fichier exécutable de l’interface CLI Databricks en exécutant la commande suivante :

    choco upgrade databricks-cli

  2. Assurez-vous que l’interface CLI Databricks est correctement installée. Pour ce faire, affichez la version de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version mis à jour attendu s’affiche, l’interface CLI Databricks est correctement installée.

    Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Versions du référentiel Interface CLI Databricks dans GitHub. La dernière version a une étiquette Latest en regard de celle-ci dans la liste des versions.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

Mise à jour curl pour Linux, macOS et Windows

Pour cette option de mise à jour, vous utilisez curl pour télécharger et mettre à jour automatiquement une installation précédente de l’interface CLI Databricks version 0.205 ou ultérieure vers la version la plus récente.

Pour Windows, Databricks vous recommande d’utiliser WSL (Sous-système Windows pour Linux). unzip doit être installé. Pour obtenir des instructions d’installation, consultez la documentation de votre système d’exploitation. Si vous ne pouvez pas utiliser WSL, vous devez ignorer cette procédure et utiliser à la place l’invite de commande ou PowerShell pour mettre à jour l’interface CLI Databricks depuis la source.

  1. Supprimez l’installation existante de l’exécutable de l’interface CLI Databricks à partir du chemin d’accès /usr/local/bin/databricks sur macOS et Linux, ou C:\Windows\databricks.exe sur Windows.

  2. À partir d’une invite d’interpréteur de commandes Linux, d’un terminal macOS ou d’une invite de commandes Windows, utilisez curl pour télécharger et installer la dernière version du fichier exécutable de l’interface CLI Databricks en exécutant la commande suivante (vous devez spécifier les caractères majuscules et minuscules corrects pour -fsSL) :

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

    Remarque

    Pour afficher le contenu du script avant de l’exécuter, consultez le fichier install.sh dans le référentiel d’installation de l’interface CLI Databricks dans GitHub.

    Pour Windows, vous devez exécuter cette commande en tant qu’administrateur.

    Pour Linux et macOS, si un message d’erreur indique que /usr/local/bin n’est pas accessible en écriture, réexécutez la commande avec sudo.

    Cette commande télécharge et installe l’exécutable de l’interface CLI Databricks dans le chemin /usr/local/bin/databricks sur macOS et Linux, et C:\Windows\databricks.exe sur Windows.

    Si l’erreur suivante s’affiche, vous devez supprimer manuellement l’exécutable de l’interface CLI Databricks du chemin précédent, puis réexécuter la commande curl : « Le chemin cible <path> existe déjà ».

  3. Assurez-vous que l’interface CLI Databricks est correctement mise à jour. Pour ce faire, à partir de votre terminal, affichez la version du fichier exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la commande version :

    databricks -v

# Or:
databricks version

    Si le numéro de version mis à jour attendu s’affiche, l’interface CLI Databricks est correctement installée.

    Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Versions du référentiel Interface CLI Databricks dans GitHub. La dernière version a une étiquette Latest en regard de celle-ci dans la liste des versions.

    Remarque

    Si vous exécutez databricks mais que vous obtenez une erreur telle que command not found: databricks, ou si vous exécutez databricks -v et qu’un numéro de version 0.18 ou inférieur est affiché, votre ordinateur ne trouve pas la version correcte de l’exécutable de l’interface CLI Databricks. Pour résoudre ce problème, consultez Vérifier l’installation de votre interface CLI.

Mise à jour source pour Linux, macOS et Windows

Pour cette option de mise à jour, vous téléchargez manuellement un fichier .zip, puis extrayez manuellement le fichier exécutable de l’interface CLI Databricks à partir du fichier .zip téléchargé.

  1. Si vous le souhaitez, supprimez le fichier exécutable de l’interface CLI Databricks, le fichier .zip et le dossier extrait du fichier .zip à partir de la procédure d’installation manuelle précédente.
  2. Continuez en suivant les instructions d’Installation source pour Linux, macOS et Windows.

Exécuter l’interface CLI Databricks à partir d’un espace de travail Azure Databricks

Vous pouvez accéder à l’interface CLI Databricks à partir du terminal web à l’intérieur d’un notebook connecté à un cluster en cours d’exécution ou directement à partir du terminal web d’un cluster en cours d’exécution. L’interface CLI disponible est toujours la dernière version, et l’authentification est basée sur l’utilisateur actuel. Le cluster doit répondre aux exigences suivantes :

  • La version 15.0 ou ultérieure de Databricks Runtime doit être installée sur le cluster.
  • Le cluster doit utiliser un mode d’accès au cluster de type Utilisateur unique ou Partagé sans isolation. Le mode d’accès au cluster Partagé n’est pas pris en charge.
  • Le calcul serverless n’est pas pris en charge.
  • L’espace de travail ne doit pas être activé pour Private Link.

Pour accéder à l’interface CLI à partir du terminal web d’un notebook, effectuez les étapes suivantes :

  1. Connectez le notebook à un cluster qui répond aux exigences précédentes.

  2. Tout en bas de la barre latérale droite du notebook, cliquez sur l’icône Ouvrir le panneau inférieurOuvrir le panneau inférieur du notebook.

  3. Utilisez l’interface CLI dans le volet Terminal qui s’affiche. Par exemple, la commande suivante affiche des informations sur l’utilisateur actuel :

    databricks current-user me

Pour accéder à l’interface CLI à partir du terminal web d’un cluster, effectuez les étapes suivantes :

  1. Dans la barre latérale de l’espace de travail, cliquez sur Calcul.

  2. Sous l’onglet Calcul à usage général, cliquez sur le nom d’un cluster qui répond aux exigences précédentes.

  3. Cliquez sur Start.

  4. Une fois le cluster démarré, sous l’onglet Applications, cliquez sur Terminal web.

  5. Utilisez l’interface CLI dans le terminal web Databricks qui s’affiche. Par exemple, la commande suivante affiche des informations sur l’utilisateur actuel :

    databricks current-user me