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

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

• Linux o macOS: use Homebrew, curl o compilaciones de origen.
• Windows: Use WinGet, Chocolatey, Subsistema de Windows para Linux (WSL) o compilaciones desde el código fuente.

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:

• Linux o macOS: Use Homebrew, curl, o compilaciones de origen.
• Windows: Use WinGet, Chocolatey, Subsistema de Windows para Linux (WSL) o compilaciones desde el código fuente.

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 terminal 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. Use Homebrew para agregar el repositorio databricks/homebrew-tap en GitHub a la lista de repositorios de Homebrew Tap disponibles; para ello, ejecute 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, verifique la versión del ejecutable de la CLI de Databricks utilizando 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, la CLI de Databricks se instala correctamente.

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 la interfaz de línea de comandos, ejecute los dos comandos winget siguientes para instalar la CLI y luego reinicie la interfaz de línea de comandos.

   winget search databricks
   winget install Databricks.DatabricksCLI
   

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

   databricks -v
   
   # Or:
   databricks version
   

Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

1. 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. Desde el Prompt de Comando, 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, verifique la versión del ejecutable de la CLI de Databricks utilizando la opción -v o ejecutando el comando version.

   databricks -v
   
   # Or:
   databricks version
   

   Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

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 el lanzamiento ejecutable más reciente de la CLI de Databricks.

Para Windows, Databricks recomienda usar 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 terminal de Linux, un terminal de 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 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 comando curl.

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

   databricks -v
   
   # Or:
   databricks version
   

   Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

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

Instalación desde la fuente para Linux, macOS y Windows

Para esta opción de instalación, descarga un archivo .zip manualmente y, a continuación, extrae manualmente el ejecutable de la CLI de Databricks a partir del archivo descargado .zip.

1. Descargue en la máquina de desarrollo local la versión más reciente de la CLI de Databricks .zip, como se muestra en la sección Releases 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 .zip archivo que descargue de la Assets sección de la versión debe coincidir con el sistema operativo y la arquitectura de la máquina de desarrollo:

   Nombre de archivo	Arquitectura
   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: el símbolo del sistema o el comando PowerShell echo %PROCESSOR_ARCHITECTURE%.

   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 verificación de suma de control, consulte la documentación de su 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 la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

   Nota:

   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, verifique la versión del ejecutable de la CLI de Databricks utilizando la opción -v o ejecutando el comando version.

   databricks -v
   
   # Or:
   databricks version
   

   Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

   Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Releases 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.

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. Paso 1: En tu símbolo del sistema, utiliza winget para descargar y actualizar a la última versión del ejecutable de la CLI de Databricks ejecutando el siguiente comando:

   winget upgrade Databricks.DatabricksCLI
   

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

   databricks -v
   
   # Or:
   databricks version
   

   Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

   Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Releases 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.

actualización de Chocolatey para Windows

Nota:

Actualizar la CLI de Databricks con Chocolatey es un experimento.

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. Desde la línea de comandos, use choco para descargar y actualizar a la versión más reciente del ejecutable de la CLI de Databricks ejecutando el siguiente comando:

   choco upgrade databricks-cli
   

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

   databricks -v
   
   # Or:
   databricks version
   

   Si la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

   Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Releases 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.

curl update 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 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 actualizar la CLI de Databricks desde la fuente en su lugar.

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

2. En un terminal de Linux, Terminal de macOS o 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, ejecutando el siguiente comando (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 de acceso /usr/local/bin/databricks 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 la salida es la versión 0.205.0 o posterior, la CLI de Databricks se instala correctamente.

   Para obtener una lista de las versiones de la CLI de Databricks, consulte la sección Releases 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.

Actualización de Source 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. Si lo desea, elimine el ejecutable de la CLI de Databricks, el archivo .zip y la carpeta extraída del archivo .zip, de cualquier procedimiento previo de instalación manual desde un origen.
2. Siga las instrucciones de instalación de Source para Linux, macOS y Windows.