Compartir a través de

Instalación o actualización de la CLI de Databricks

  • Artículo

Nota:

Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

En este artículo se describe cómo instalar o actualizar la CLI de Databricks. Consulte ¿Qué es la CLI de Databricks?. Para configurar la autenticación de la CLI de Databricks, consulte Autenticación de la CLI de Databricks.

Instalar

Para instalar la versión 0.205 o una posterior de CLI de Databricks:

La CLI de Databricks también está disponible desde la interfaz de usuario del área de trabajo de Azure Databricks. Consulte Ejecución de comandos de la CLI de Databricks.

Actualizar

Para actualizar una instalación anterior de la CLI de Databricks versión 0.205 o posterior:

Instalación de Homebrew para Linux o macOS

Para esta opción de instalación, usará Homebrew para descargar e instalar automáticamente la versión ejecutable más reciente de la CLI de Databricks.

Desde el terminal, solo tiene que ejecutar los dos comandos de Homebrew siguientes para instalar la CLI:

brew tap databricks/tap
brew install databricks

A continuación, continúe con Autenticación para la CLI de Databricks.

Si no está seguro de si tiene Homebrew instalado o si se produce un error en los comandos Homebrew anteriores, siga estas instrucciones más largas:

  1. Compruebe si Homebrew ya está instalado ejecutando el siguiente comando desde un símbolo del sistema del shell de Linux o desde el terminal de macOS. Si Homebrew está instalado, se muestra el número de versión del Homebrew:

    brew -v

  2. Si HomeBrew si no está ya instalado, puede hacerlo ejecutando el comando siguiente:

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

    A continuación, ejecute el siguiente comando para comprobar la instalación de Homebrew, que muestra el número de versión Homebrew:

    brew -v

  3. Utiliza Homebrew para añadir el repositorio databricks/homebrew-tap en GitHub a tu lista de repositorios disponibles de Homebrew Tap, ejecutando el siguiente comando:

    brew tap databricks/tap

  4. Use Homebrew para indicar al databricks/homebrew-tap repositorio que descargue e instale el ejecutable de la CLI de Databricks mediante la ejecución del siguiente comando:

    brew install databricks

  5. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si aparece un número de versión de 0.205.0 o superior, significa que la CLI de Databricks está instalada correctamente.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

  6. Continúe con la Autenticación de la CLI de Databricks.

instalación de WinGet para Windows

Para esta opción de instalación, usará winget para descargar e instalar automáticamente la versión ejecutable más reciente de la CLI de Databricks.

  1. En el símbolo del sistema, ejecute los dos comandos winget siguientes para instalar la CLI y, a continuación, reinicie el símbolo del sistema:

    winget search databricks
winget install Databricks.DatabricksCLI

  2. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si aparece un número de versión de 0.205.0 o superior, significa que la CLI de Databricks está instalada correctamente.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

  3. Continúe con la Autenticación de la CLI de Databricks.

Instalación de Chocolatey para Windows

Nota:

La instalación de la CLI de Databricks con Chocolatey es Experimental.

Para esta opción de instalación, usará Chocolatey para descargar e instalar automáticamente la versión más reciente del ejecutable de la CLI de Databricks.

  1. En el símbolo del sistema, ejecute el siguiente comando choco para instalar la CLI:

    choco install databricks-cli

  2. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si aparece un número de versión de 0.205.0 o superior, significa que la CLI de Databricks está instalada correctamente.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

  3. Continúe con la Autenticación de la CLI de Databricks.

instalación de curl para Linux, macOS y Windows

Para esta opción de instalación, usará curl para descargar e instalar automáticamente la versión ejecutable más reciente de la CLI de Databricks.

Para Windows, Databricks recomienda usar el Subsistema de Windows para Linux (WSL). También debe tener unzip instalado. Para obtener instrucciones de instalación, consulte la documentación del sistema operativo. Si no puede usar WSL, omita este procedimiento y use el símbolo del sistema o PowerShell para instalar la CLI de Databricks desde el origen en su lugar.

  1. curl debe estar instalado. Puede comprobar si curl ya está instalado ejecutando el siguiente comando desde un símbolo del sistema del shell de Linux, un terminal macOS o Bash en WSL. Si curl está instalado, se muestra el curl número de versión:

    curl -V

  2. Si curl aún no está instalado, instálelo siguiendo las instrucciones de la página curlVersiones y descargas del sistema operativo y la arquitectura. Para obtener la arquitectura de la máquina, consulte la documentación del sistema operativo.

    A continuación, ejecute el siguiente comando para comprobar la instalación de curl, que muestra el número de versión curl:

    curl -V

  3. Use curl para descargar e instalar el ejecutable de la CLI de Databricks mediante la ejecución del siguiente comando (tenga en cuenta que debe especificar los caracteres en mayúsculas y minúsculas correctos para -fsSL en todos los sistemas operativos):

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

    Nota:

    Para ver el contenido del script antes de ejecutarlo, consulte el archivo install.sh en el repositorio de instalación de la CLI de Databricks en GitHub.

    Para Windows, debe ejecutar este comando como administrador.

    Para Linux y macOS, si un mensaje de error indica que /usr/local/bin no se puede escribir, vuelva a ejecutar el comando con sudo.

    Este comando descarga e instala el ejecutable de la CLI de Databricks en la ruta /usr/local/bin/databricks de acceso en macOS y Linux y C:\Windows\databricks.exe en Windows.

    Si por alguna razón la CLI de Databricks ya está instalada, aparece el siguiente error: "La ruta <path> de acceso de destino ya existe". Para corregirlo, debe eliminar manualmente el ejecutable de la CLI de Databricks de la ruta de acceso anterior y, a continuación, volver a ejecutar el curl comando.

  4. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si aparece un número de versión de 0.205.0 o superior, significa que la CLI de Databricks está instalada correctamente.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

  5. Continúe con la Autenticación de la CLI de Databricks.

Instalación de origen para Linux, macOS y Windows

Para esta opción de instalación, descargará manualmente un .zip archivo y, a continuación, extraerá manualmente el ejecutable de la CLI de Databricks del archivo descargado .zip.

  1. Descargue en la máquina de desarrollo local el archivo .zip de la CLI de Databricks más reciente, como se muestra en la sección Versiones del repositorio de la CLI de Databricks en GitHub. La versión más reciente tiene una etiqueta Latest junto a ella en la lista de versiones. La versión preliminar más reciente tiene una etiqueta Pre-release y es más adecuada para experimentación y usuarios pioneros. El archivo .zip que descargue de la sección Assets de la versión debe coincidir con el sistema operativo y la arquitectura de la máquina de desarrollo:

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

    Para obtener la arquitectura de la máquina, consulte la documentación del sistema operativo. Por ejemplo:

    • Linux: los comandos de terminal uname -m, lscpu o sudo lshw -c cpu.
    • macOS: menú de icono de Apple>Acerca de este equipo Maco el comando de Terminal uname -m.
    • Windows: símbolo del sistema o comando echo %PROCESSOR_ARCHITECTURE% de PowerShell.

    Si necesita comprobar la integridad de uno de estos .zip archivos, Databricks proporciona un archivo de suma de comprobación denominado databricks_cli_X.Y.Z_SHA256SUMS en la misma lista que los .zip archivos. Para ejecutar una comprobación de suma de comprobación, consulte la documentación del sistema operativo.

  2. Extraiga el contenido del archivo .zip descargado. Para extraer el archivo, consulte la .zip documentación del sistema operativo.

  3. En el contenido extraído, aparece una carpeta con el mismo nombre que el .zip archivo. Dentro de esta carpeta se encuentra el ejecutable de la CLI de Databricks. Puede dejar allí el ejecutable de la CLI de Databricks, o puede copiarlo o moverlo a otra ubicación.

  4. Confirme si la CLI de Databricks está instalada correctamente. Para ello, desde un símbolo del sistema del shell de Linux, un terminal de macOS o un símbolo del sistema de Windows, vea la versión del ejecutable de la CLI de Databricks mediante la opción -v o ejecutando el comando version:

    databricks -v

# Or:
databricks version

    Si aparece un número de versión de 0.205.0 o superior, significa que la CLI de Databricks está instalada correctamente.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

    En el caso de macOS, es posible que tenga que autorizar al sistema para poder ejecutar primero la CLI de Databricks. Consulte Abrir una aplicación mac desde un desarrolladorno identificado.

  5. Continúe con la Autenticación de la CLI de Databricks.

Actualización de Homebrew para Linux o macOS

Para esta opción de actualización, use Homebrew para actualizar automáticamente una instalación anterior de la CLI de Databricks versión 0.205 o posterior a la versión más reciente.

  1. Desde un símbolo del sistema de shell de Linux o un terminal de macOS, use Homebrew para descargar y actualizar a la versión más reciente del ejecutable de la CLI de Databricks mediante la ejecución del siguiente comando:

    brew upgrade databricks

  2. Confirme si la CLI de Databricks se ha actualizado correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si se muestra el número de versión actualizado esperado, la CLI de Databricks se instala correctamente.

    Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Versiones del repositorio de la CLI de Databricks en GitHub. La versión más reciente tiene una etiqueta Latest junto a ella en la lista de versiones.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

Sugerencia

Para degradar la versión de la CLI de Databricks, consulte las instrucciones del repositorio databricks/homebrew-tap en GitHub.

Actualización de WinGet para Windows

Para esta opción de actualización, usará winget para descargar y actualizar automáticamente una versión anterior de la CLI de Databricks versión 0.205 o posterior a la versión más reciente.

  1. En el símbolo del sistema, use winget para descargar y actualizar a la versión más reciente del ejecutable de la CLI de Databricks mediante la ejecución del comando siguiente:

    winget upgrade Databricks.DatabricksCLI

  2. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si se muestra el número de versión actualizado esperado, la CLI de Databricks se instala correctamente.

    Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Versiones del repositorio de la CLI de Databricks en GitHub. La versión más reciente tiene una etiqueta Latest junto a ella en la lista de versiones.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

Actualización de Chocolatey para Windows

Nota:

La actualización de la CLI de Databricks con Chocolatey es Experimental.

Para esta opción de actualización, usará Chocolatey para descargar y actualizar automáticamente una versión anterior de la CLI de Databricks versión 0.205 o posterior a la versión más reciente.

  1. En el símbolo del sistema, use choco para descargar y actualizar a la versión más reciente del ejecutable de la CLI de Databricks mediante la ejecución del comando siguiente:

    choco upgrade databricks-cli

  2. Confirme si la CLI de Databricks está instalada correctamente. Para ello, vea la versión del ejecutable de la CLI de Databricks mediante la -v opción o ejecutando el version comando:

    databricks -v

# Or:
databricks version

    Si se muestra el número de versión actualizado esperado, la CLI de Databricks se instala correctamente.

    Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Versiones del repositorio de la CLI de Databricks en GitHub. La versión más reciente tiene una etiqueta Latest junto a ella en la lista de versiones.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

actualización de curl para Linux, macOS y Windows

Para esta opción de actualización, use curl para descargar y actualizar automáticamente una instalación anterior de la CLI de Databricks versión 0.205 o posterior a la versión más reciente.

Para Windows, Databricks recomienda usar el Subsistema de Windows para Linux (WSL). Debe tener instalado unzip. Para obtener instrucciones de instalación, consulte la documentación del sistema operativo. Si no puede usar WSL, debe omitir este procedimiento y usar el símbolo del sistema o PowerShell para instalar la CLI de Databricks desde el origen en su lugar.

  1. Elimine la instalación existente del ejecutable de la CLI de Databricks desde la ruta /usr/local/bin/databricks de acceso en macOS y Linux, o C:\Windows\databricks.exe en Windows.

  2. Desde un símbolo del sistema del shell de Linux, un terminal de macOS o un símbolo del sistema de Windows, use curl para descargar e instalar la versión más reciente del ejecutable de la CLI de Databricks mediante la ejecución del comando siguiente (tenga en cuenta que debe especificar los caracteres en mayúsculas y minúsculas correctos para -fsSL):

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

    Nota:

    Para ver el contenido del script antes de ejecutarlo, consulte el archivo install.sh en el repositorio de instalación de la CLI de Databricks en GitHub.

    Para Windows, debe ejecutar este comando como administrador.

    Para Linux y macOS, si un mensaje de error indica que /usr/local/bin no se puede escribir, vuelva a ejecutar el comando con sudo.

    Este comando descarga e instala el ejecutable de la CLI de Databricks en la ruta /usr/local/bin/databricks de acceso en macOS y Linux y C:\Windows\databricks.exe en Windows.

    Si aparece el siguiente error, debe eliminar manualmente el ejecutable de la CLI de Databricks de la ruta de acceso anterior y, a continuación, volver a ejecutar el curl comando: "Ruta de acceso <path> de destino ya existe".

  3. Confirme si la CLI de Databricks se ha actualizado correctamente. Para ello, desde el terminal, vea la versión del ejecutable de la CLI de Databricks mediante la opción -v o ejecutando el comando version:

    databricks -v

# Or:
databricks version

    Si se muestra el número de versión actualizado esperado, la CLI de Databricks se instala correctamente.

    Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Versiones del repositorio de la CLI de Databricks en GitHub. La versión más reciente tiene una etiqueta Latest junto a ella en la lista de versiones.

    Nota:

    Si ejecuta databricks pero recibe un error como command not found: databricks, o si ejecuta databricks -v y aparece un número de versión de 0.18 o inferior, significa que la máquina no encuentra la versión correcta del ejecutable de la CLI de Databricks. Para corregirlo, consulte Comprobación de la instalación de la CLI.

Actualización de origen para Linux, macOS y Windows

Para esta opción de actualización, descargará manualmente un archivo .zip y, a continuación, extraerá manualmente el archivo ejecutable de la CLI de Databricks del archivo .zip descargado.

  1. Opcionalmente, elimine el archivo ejecutable de la CLI de Databricks, el archivo .zip y la carpeta extraída del archivo .zip, de cualquier procedimiento de instalación manual de origen anterior.
  2. Siga las instrucciones de Instalación de origen para Linux, macOS y Windows.