Partager via

Installer ou mettre à jour l’interface CLI Databricks

  • Article

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.

Cet article explique comment installer ou mettre à jour l’interface CLI Databricks. Consultez Présentation de l’interface CLI Databricks. Pour configurer l’authentification pour l’interface Databricks CLI, consultez Authentification pour l’interface Databricks CLI.

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. Voir Exécuter des commandes CLI Databricks.

Update

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 fournies dans la page des versions et téléchargements de curl pour votre système d’exploitation et 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.

Conseil

Pour passer à une version inférieure de l’interface CLI Databricks, consultez les instructions du référentiel databricks/homebrew-tap dans GitHub.

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.