Solución de problemas 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.

Use la siguiente información para solucionar problemas con la CLI de Databricks.

Habilitar registro

Si se produce un error en un comando o no genera la salida esperada, puede usar el registro para ayudar a identificar lo que podría haber ido mal. Puede registrar mensajes que genera la CLI de Databricks sobre varios eventos de comandos, advertencias y errores. Para registrar estos mensajes, especifique las siguientes opciones de comando de la CLI de Databricks:

Marca Descripción
--log-file Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.
--log-format text para escribir registros de salida en texto o json para escribir registros de salida en JSON. Si no se especifica esta marca, los registros de salida se escriben como texto.
--log-level El nivel de formato de registro está representado por una cadena. Los niveles de registro válidos son error, warn, info, debug, tracey disabled. El nivel predeterminado es disabled, lo que significa que no se registra nada. --debug equivale a --log-level debug.

El siguiente comando de ejemplo registra los mensajes de seguimiento del comando especificado en un archivo denominado databricks-cli.log en formato JSON.

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

Error al descargar Terraform

Una clave expirada en algunas versiones de la CLI de Databricks provoca el siguiente error al ejecutar databricks bundle deploy:

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

Para resolver este error, actualice la CLI de Databricks a una versión revisada más reciente, que actualiza el mecanismo de comprobación para trabajar con una clave más reciente. Actualice a la versión revisada correspondiente a la versión secundaria de la CLI actual:

  • Binary install: descargue la versión revisada de la página de versiones de la CLI de Databricks en GitHub.

  • setup-cli (como script de instalación o acción de GitHub): actualice la versión de la configuración a una versión revisada desde la página de versiones de la CLI de Databricks en GitHub.

    Por ejemplo, para usar 0.296.1 con la acción GitHub:

    - uses: databricks/setup-cli@main
      with:
        version: 0.296.1
    

Comandos sin completar

Si ejecuta un comando como databricks cluster list y parece que se bloquea, actualice la versión de la CLI de Databricks a la versión más reciente. Las versiones anteriores de la CLI intentarían cargar listas completas incluso si el número de elementos de la lista era grande y el comando parecería no finalizar.