Installer ou mettre à jour l’interface CLI Databricks

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.

• Linux ou macOS : utilisez Homebrew, curlou les builds sources.
• Windows : utilisez WinGet, Chocolatey, Sous-système Windows pour Linux (WSL) ou des builds sources.

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.

Mise à jour

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

• Linux ou macOS : utilisez Homebrew, curlou les builds sources.
• Windows : utilisez WinGet, Chocolatey, Sous-système Windows pour Linux (WSL) ou des builds sources.

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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si le numéro de version 0.205.0 ou supérieur est répertorié, l’interface CLI Databricks est installée correctement.

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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

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

Installation de Chocolatey pour Windows

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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

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 curl de pour votre système d’exploitation et votre architecture. Pour obtenir 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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

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 Latest étiquette à côté 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 .zip fichier que vous téléchargez à partir de la Assets section 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 Série / 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 obtenir 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 .zip fichiers, Databricks fournit un fichier de somme de contrôle nommé databricks_cli_X.Y.Z_SHA256SUMS dans la même liste que les .zip fichiers. 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, consultez la .zip 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 de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

   Remarque

   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 Databricks CLI version 0.205 ou ultérieure vers la dernière version.

1. Depuis une invite de commande Linux ou un terminal macOS, utilisez Homebrew pour télécharger et mettre à jour l'exécutable du CLI Databricks vers la dernière version 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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

   Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Releases du référentiel CLI Databricks dans GitHub. La dernière version a une Latest étiquette à côté dans la liste des versions.

Mise à jour WinGet pour Windows

Pour cette option de mise à jour, vous utilisez winget pour télécharger et mettre à jour automatiquement une version antérieure de Databricks CLI version 0.205 ou ultérieure vers la dernière version.

1. À partir de votre invite de commandes, utilisez winget pour télécharger et mettre à jour vers la dernière version de l’exécutable 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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

   Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Releases du référentiel CLI Databricks dans GitHub. La dernière version a une Latest étiquette à côté dans la liste des versions.

Mise à jour chocolatey pour Windows

Pour cette option de mise à jour, vous utilisez Chocolatey pour télécharger et mettre à jour automatiquement une version antérieure de Databricks CLI version 0.205 ou ultérieure vers la dernière version.

1. À partir de votre invite de commandes, utilisez choco pour télécharger et mettre à jour vers la dernière version de l’exécutable 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 version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

   Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Releases du référentiel CLI Databricks dans GitHub. La dernière version a une Latest étiquette à côté dans la liste des versions.

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 Databricks CLI version 0.205 ou ultérieure vers la dernière version.

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. Dans le cas où vous ne pouvez pas utiliser WSL, vous devez ignorer cette procédure et utiliser l’invite de commandes ou PowerShell pour mettre à jour la CLI Databricks à partir de 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 de l’exécutable de l’interface CLI Databricks à l’aide de l’option -v ou en exécutant la version commande :

   databricks -v
   
   # Or:
   databricks version
   

   Si la sortie est la version 0.205.0 ou ultérieure, l’interface CLI Databricks est installée correctement.

   Pour obtenir la liste des versions de l’interface CLI Databricks, consultez la section Releases du référentiel CLI Databricks dans GitHub. La dernière version a une Latest étiquette à côté dans la liste des versions.

Mise à jour source pour Linux, macOS et Windows

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

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