Aller au contenu principal
Dernière mise à jour le

Installez ou mettez à jour le Databricks CLI

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.

Cette page décrit comment installer ou mettre à jour la CLI Databricks. Consultez Databricks CLI. Pour configurer l'authentification pour Databricks CLI, consultez Authentification pour Databricks CLI.

Installer​

Pour installer Databricks CLI version 0,205 ou ultérieure :

La CLI Databricks est également disponible à partir du workspace Databricks. Consulter Exécuter les commandes CLI Databricks.

Mettre à jour​

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

Installation de Homebrew pour macOS​

Pour cette option d'installation, vous utilisez Homebrew pour download et installer automatiquement la dernière version de CLI Databricks.

Depuis votre terminal, exécutez les commandes Homebrew suivantes pour installer la CLI :

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

La commande brew trust est requise à partir de Homebrew 6.0.0, qui exige que les taps tiers soient explicitement approuvés avant que Homebrew ne charge leurs formules. Les utilisateurs existants qui ont tapé avant la mise à niveau vers Homebrew 6.0.0 doivent également exécuter brew trust databricks/tap.

Vous pouvez également installer en une seule étape sans faire confiance à l'ensemble du tap :

Bash
brew install databricks/tap/databricks

Poursuivez ensuite avec Authentification pour la CLI Databricks.

Si vous n’êtes pas sûr d’avoir Homebrew 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 Shell Linux ou du Terminal macOS. Si Homebrew est installé, le numéro de version Homebrew s’affiche :

    Bash
    brew -v

  2. Si Homebrew n'est pas déjà installé, installez-le en exécutant la commande suivante :

    Bash
    /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 de Homebrew, qui affiche le numéro de version de Homebrew :

    Bash
    brew -v

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

    Bash
    brew tap databricks/tap

  4. Faites confiance au tap. À partir de Homebrew 6.0.0, les référentiels tiers doivent être explicitement approuvés avant que Homebrew ne charge leurs formules. Exécutez la commande suivante :

    Bash
    brew trust databricks/tap

    Les utilisateurs existants qui ont utilisé avant de passer à Homebrew 6.0.0 doivent également exécuter cette commande.

  5. Utilisez Homebrew pour demander au repository databricks/homebrew-tap de download et d'installer le CLI Databricks en exécutant la commande suivante :

    Bash
    brew install databricks

  6. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, consultez la version de la CLI Databricks à l'aide de l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si une version 0.205.0 ou supérieure est affichée, la CLI Databricks est correctement installée.

  7. Continuer avec l'authentification pour la CLI Databricks.

Installation de WinGet pour Windows​

Pour cette option d’installation, vous utilisez winget pour download et installer automatiquement la dernière version de Databricks CLI.

  1. Depuis votre invite de commande, exécutez les deux commandes winget suivantes pour installer la CLI, puis redémarrez votre invite de commande :

    Bash
    winget search databricks
    winget install Databricks.DatabricksCLI

  2. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

  1. Continuer avec l'authentification pour la CLI Databricks.

Installation de Chocolatey pour Windows​

remarque

L'installation de la CLI Databricks avec Chocolatey est expérimentale.

Pour cette option d'installation, vous utilisez Chocolatey pour download et installer automatiquement la dernière version du CLI Databricks.

  1. À partir de votre invite de commande, exécutez la commande choco suivante pour installer la CLI :

    Bash
    choco install databricks-cli

  2. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

  3. Continuer avec l'authentification pour la CLI Databricks.

Installation de curl pour Linux, macOS et Windows​

Pour cette option d'installation, vous utilisez curl pour download et invoquer un script afin d'installer la dernière version de Databricks CLI.

Pour Windows, Databricks recommande d'utiliser Windows Subsystem for Linux (WSL). Vous devez également avoir unzip installé. Pour les 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 l'invite de commande ou PowerShell pour installer l'interface CLI Databricks à partir de la source à la place.

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

    Bash
    curl -V

  2. Si curl n'est pas déjà installé, installez-le en suivant les instructions sur la page curl Versions et téléchargements pour votre système d'exploitation et votre architecture. Pour obtenir l'architecture de votre machine, 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 curl :

    Bash
    curl -V

  3. Utilisez curl pour download et installer le Databricks CLI en exécutant la commande suivante. Cette commande est sensible à la casse.

    Bash
    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 repository Databricks CLI Setup sur GitHub.

Pour Windows, vous devriez exécuter cette commande en tant qu'administrateur.

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

Cette commande download et installe la 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, le CLI Databricks est déjà installé, l'erreur suivante apparaît : « Le chemin cible <path> existe déjà. » Pour corriger cela, vous devez supprimer manuellement le CLI Databricks du chemin précédent, puis exécuter à nouveau la commande curl. 4. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

Bash
databricks -v

# Or:
databricks version

Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement. 5. Continuer avec l'authentification pour la CLI Databricks.

Installation à partir de la source pour Linux, macOS et Windows​

Pour cette option d'installation, vous download manuellement un fichier .zip puis extrayez manuellement le CLI Databricks du fichier .zip download.

  1. Download sur votre machine de développement locale le dernier fichier .zip de la CLI Databricks, tel qu'il est répertorié dans la section Versions du repository de la CLI Databricks sur GitHub. La dernière version a une étiquette Latest à côté d’elle 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 adoptants précoces. Le fichier .zip que vous download à partir de la section Assets pour la version doit correspondre au système d’exploitation et à l’architecture de votre machine 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 / Série M / 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-bit / x86

    databricks_cli_X.Y.Z_windows_amd64.zip

    Windows, Intel 64-bit / AMD64

    databricks_cli_X.Y.Z_windows_arm64.zip

    Windows, ARM 64 bits / ARM64

    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 / Série M / 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-bit / x86

    databricks_cli_X.Y.Z_windows_amd64.zip

    Windows, Intel 64-bit / AMD64

    databricks_cli_X.Y.Z_windows_arm64.zip

    Windows, ARM 64 bits / ARM64

    Pour obtenir l'architecture de votre machine, consultez la documentation de votre système d'exploitation. Par exemple :

    • Linux : Les commandes de terminal uname -m, lscpu ou sudo lshw -c cpu.
    • macOS : menu de l’icône Apple > À propos de ce Mac , ou la commande Terminal uname -m.
    • Windows : la commande Invite de commandes ou 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 download. Pour extraire le fichier .zip, consultez la documentation de votre système d’exploitation.

  3. Dans le contenu extrait, un dossier apparaît portant le même nom que le fichier .zip. Ce dossier contient le Databricks CLI. Vous pouvez y laisser l'interface de ligne de commande Databricks, ou vous pouvez la copier ou la déplacer vers un autre emplacement.

  4. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, à partir d'une invite de commande Shell Linux, du Terminal macOS ou de l'Invite de commande Windows, affichez la version de la CLI Databricks à l'aide de l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

remarque

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

  1. Continuer avec l'authentification pour la 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 supérieure vers la dernière version.

  1. Depuis une invite de commande Shell Linux ou un Terminal macOS, utilisez Homebrew pour download et mettre à jour vers la dernière version de Databricks CLI en exécutant la commande suivante :

    Bash
    brew upgrade databricks

  2. Confirmez si la CLI Databricks est correctement mise à jour. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

    Pour une liste des versions de Databricks CLI, consultez la section Releases du repository Databricks CLI sur GitHub. La dernière version porte l'étiquette Latest à côté d'elle dans la liste des versions.

astuce

Pour rétrograder la version de la CLI Databricks, consultez les instructions dans le repository databricks/homebrew-tap sur GitHub.

Mise à jour WinGet pour Windows​

Pour cette option de mise à jour, vous utilisez winget pour download et mettre à jour automatiquement une version précédente de Databricks CLI version 0,205 ou supérieure vers la dernière version.

  1. Depuis votre invite de commandes, utilisez winget pour download et mettre à jour la dernière version du Databricks CLI en exécutant la commande suivante :

    Bash
    winget upgrade Databricks.DatabricksCLI

  2. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

    Pour une liste des versions de Databricks CLI, consultez la section Releases du repository Databricks CLI sur GitHub. La dernière version porte l'étiquette Latest à côté d'elle dans la liste des versions.

Mise à jour Chocolatey pour Windows​

remarque

La mise à jour de la CLI Databricks avec Chocolatey est expérimentale.

Pour cette option de mise à jour, vous utilisez Chocolatey pour download et mettre à jour automatiquement une version précédente de la CLI Databricks version 0.205 ou supérieure vers la dernière version.

  1. Depuis votre invite de commandes, utilisez choco pour download et mettre à jour la dernière version du Databricks CLI en exécutant la commande suivante :

    Bash
    choco upgrade databricks-cli

  2. Confirmez si la CLI Databricks est installée correctement. Pour ce faire, visualisez la version de l'interface CLI Databricks en utilisant l'option -v ou en exécutant la commande version :

    Bash
    databricks -v

    # Or:
    databricks version

    Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

    Pour une liste des versions de Databricks CLI, consultez la section Releases du repository Databricks CLI sur GitHub. La dernière version porte l'étiquette Latest à côté d'elle dans la liste des versions.

Mise à jour curl pour Linux, macOS et Windows​

Pour cette option de mise à jour, vous utilisez curl pour download 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 recommande d'utiliser Windows Subsystem for Linux (WSL). Vous devez avoir unzip installé. Pour les 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 l'invite de commandes ou PowerShell pour mettre à jour la CLI Databricks à partir de la source.

  1. Supprimez l'installation existante de la CLI Databricks du chemin /usr/local/bin/databricks sur macOS et Linux, ou C:\Windows\databricks.exe sur Windows.

  2. À partir d'une invite de shell Linux, du Terminal macOS ou de l'invite de commande Windows, utilisez curl pour download et installer la dernière version de la CLI Databricks en exécutant la commande suivante (notez que vous devez spécifier les caractères en majuscules et minuscules corrects pour -fsSL) :

    Bash
    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 repository Databricks CLI Setup sur GitHub.

Pour Windows, vous devriez exécuter cette commande en tant qu'administrateur.

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

Cette commande download et installe la CLI Databricks dans le chemin /usr/local/bin/databricks sur macOS et Linux, et C:\Windows\databricks.exe sur Windows.

Si l'erreur suivante apparaît, vous devez supprimer manuellement le Databricks CLI du chemin précédent, puis exécuter la commande curl à nouveau : « Le chemin cible <path> existe déjà. » 3. Confirmez si la CLI Databricks est correctement mise à jour. Pour ce faire, depuis votre terminal, visualisez la version de la CLI Databricks à l'aide de l'option -v ou en exécutant la commande version :

Bash
databricks -v

# Or:
databricks version

Si la sortie est la version 0,205,0 ou supérieure, la CLI Databricks est installée correctement.

Pour une liste des versions de Databricks CLI, consultez la section Releases du repository Databricks CLI sur GitHub. La dernière version porte l'étiquette Latest à côté d'elle dans la liste des versions.

Mise à jour de la source pour Linux, macOS et Windows​

Pour cette option de mise à jour, vous download manuellement un fichier .zip, puis extrayez manuellement l'exécutable CLI Databricks du fichier .zip download.

  1. Supprimez éventuellement l'exécutable Databricks CLI, le fichier .zip et le dossier extrait du fichier .zip, de toute installation manuelle précédente.
  2. Poursuivez en suivant les instructions de l'installation à partir des sources pour Linux, macOS et Windows.
Sur cette page