Compartir a través de

Tutorial 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.

La utilidad de la interfaz de la línea de comandos de Databricks (también conocida como CLI de Databricks) ofrece una interfaz fácil de usar para automatizar la plataforma de Azure Databricks desde su terminal, símbolo del sistema o scripts de automatización.

En este artículo se muestra cómo usar la máquina de desarrollo local para empezar a trabajar rápidamente con la CLI de Databricks. Consulte ¿Qué es la CLI de Databricks?.

En el siguiente tutorial práctico se da por hecho lo siguiente:

Complete los pasos siguientes:

  1. Si aún no está instalado, instale la CLI de Databricks de la siguiente manera:

    Linux, macOS

    Use Homebrew para instalar la CLI de Databricks mediante la ejecución de los dos comandos siguientes:

    brew tap databricks/tap
brew install databricks

    Windows

    Puede usar winget, Chocolatey o el Subsistema de Windows para Linux (WSL) a fin de instalar la CLI de Databricks. Si no puede usar winget, Chocolatey o 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.

    Nota:

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

    A fin de usar winget para instalar la CLI de Databricks, ejecute los dos comandos siguientes y reinicie el símbolo del sistema:

    winget search databricks
winget install Databricks.DatabricksCLI

    Para usar Chocolatey a fin de instalar la CLI de Databricks, ejecute el siguiente comando:

    choco install databricks-cli

    Para usar WSL a fin de instalar la CLI de Databricks, haga lo siguiente:

    1. Instale curl y zip mediante WSL. Para más información, consulte la documentación del sistema operativo.

    2. Use WSL para instalar la CLI de Databricks mediante la ejecución del siguiente comando:

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

  2. Confirme que la CLI de Databricks está instalada mediante la ejecución del siguiente comando, que muestra la versión actual instalada de la CLI de Databricks: Esta versión debe ser 0.205.0 o superior.

    databricks -v

    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.

Después de instalar la CLI de Databricks, complete los pasos siguientes:

Nota:

En este tutorial se supone que quiere usar la autenticación de usuario a máquina (U2M) de OAuth para autenticar la CLI mediante la cuenta de usuario de Azure Databricks. Para configurar la CLI para que use otros tipos de autenticación de Databricks, consulte Autenticación para la CLI de Databricks.

  1. Use el CLI de Databricks para iniciar la administración de tokens de OAuth localmente mediante la ejecución del siguiente comando para cada cuenta o área de trabajo de destino.

    Para operaciones de nivel de cuenta, en el comando siguiente, reemplace los siguientes marcadores de posición:

    databricks auth login --host <account-console-url> --account-id <account-id>

    Para las operaciones de nivel de área de trabajo, en el comando siguiente, reemplace <workspace-url> por la dirección URL de Azure Databricks por área de trabajo, por ejemplo, https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. La CLI de Databricks le pide que guarde la información que especificó como un perfil de configuración de Azure Databricks. Presione Enter para aceptar el nombre del perfil sugerido o escriba el nombre de un perfil nuevo o existente. Cualquier perfil existente con el mismo nombre se sobrescribe con la información que especificó. Puede usar perfiles para cambiar rápidamente el contexto de autenticación entre varias cuentas o áreas de trabajo.

    Para obtener una lista de los perfiles existentes, en un terminal o símbolo del sistema independiente, use la CLI de Databricks para ejecutar el comando databricks auth profiles. Para ver la configuración existente de un perfil específico, ejecute el comando databricks auth env --profile <profile-name>.

  3. En el explorador web, complete las instrucciones en pantalla para iniciar sesión en su cuenta o área de trabajo de Azure Databricks.

  4. Para ver el valor actual del token de OAuth de un perfil y la próxima marca de tiempo de expiración del token, ejecute uno de los siguientes comandos:

    Para operaciones de nivel de cuenta, ejecute los siguientes comandos:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Si tiene varios perfiles con los mismos valores de --host y --account-id, es posible que tenga que especificar las opciones de --host, --account-id, y -p juntas para ayudar a la CLI de Databricks a encontrar la información correcta del token de OAuth coincidente.

    Para operaciones de nivel de área de trabajo, ejecute los comandos siguientes:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Si tiene varios perfiles con los mismos valores de --host, es posible que tenga que especificar las opciones de --host y -p juntas para ayudar a la CLI de Databricks a encontrar la información correcta del token de OAuth coincidente.

Pasos siguientes

Después de configurar la CLI de Databricks: