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, que se encuentran en Versión preliminar pública. Para encontrar su versión de la CLI de Databricks, ejecute databricks -v.

En este artículo se describe cómo instalar o actualizar la CLI de Databricks. Consulte ¿Qué es la CLI de Databricks?.

Instalar

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

• Linux o macOS: use Homebrew, curlo compilaciones de origen.
• Windows: Use WinGet, Chocolatey, Subsistema de Windows para Linux (WSL) o compilaciones de origen.

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

Actualizar

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

• Linux o macOS: use Homebrew, curlo compilaciones de origen.
• Windows: Use WinGet, Chocolatey, Subsistema de Windows para Linux (WSL) o compilaciones de origen.

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.

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.

Ejecución de la CLI de Databricks desde un área de trabajo de Azure Databricks

Es posible acceder a la CLI de Databricks desde el terminal web dentro de un cuaderno conectado a un clúster en ejecución o directamente desde el terminal web para un clúster en ejecución. La versión de la CLI disponible siempre es la más reciente y la autenticación se basa en el usuario actual. El clúster debe cumplir los siguientes requisitos:

• El clúster debe tener instalado Databricks Runtime 15.0 o superior.
• El clúster debe usar un modo de acceso de clúster de Usuario único o Sin aislamiento compartido. No se admite el modo de acceso compartido del clúster.
• No se admite el proceso sin servidor.
• El área de trabajo no debe estar habilitada para Private Link.

Para acceder a la CLI desde el terminal web de un cuaderno, haga lo siguiente:

1. Conecte el cuaderno a un clúster que cumpla con los requisitos anteriores.

2. En la parte inferior de la barra lateral derecha del cuaderno, haga clic en el icono Abrir panel inferior.

3. Use la CLI del panel Terminal que aparecerá. Por ejemplo, el siguiente comando imprime información sobre el usuario actual:

   databricks current-user me
   

Para acceder a la CLI desde el terminal web de un clúster, haga lo siguiente:

1. En la barra lateral del área de trabajo, haga clic en Proceso.

2. En la pestaña Proceso multiuso, haga clic en el nombre de un clúster que cumpla con los requisitos anteriores.

3. Haga clic en Iniciar.

4. Después de que se inicie el clúster, en la pestaña Aplicaciones, haga clic en Terminal web.

5. Use la CLI del terminal web de Databricks que aparecerá. Por ejemplo, el siguiente comando imprime información sobre el usuario actual:

   databricks current-user me