Solución de problemas de la CLI de Databricks

Nota:

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
  

Error de credenciales almacenadas

A partir de la versión 1.0.0 de la CLI de Databricks, la CLI de Databricks almacena tokens de autenticación de usuario a máquina (U2M) en almacenamiento seguro nativo del sistema operativo (llavero en macOS, Credential Manager en Windows, servicio secreto de D-Bus en Linux) en lugar de un archivo JSON. Consulte Almacenamiento de tokens. Si el flujo de trabajo se basa en el archivo JSON, no funcionará con el nuevo método de almacenamiento y es posible que encuentre problemas en los escenarios siguientes:

• Actualizado a disponibilidad general, pero aún no ha iniciado sesión de nuevo. La CLI de Databricks ya no lee las credenciales almacenadas por versiones anteriores y devuelve un error:

  Stored credentials from older CLI versions are no longer used.
  Run "databricks auth login" to sign in again.
  
  If secure storage is not available in this environment, set
  DATABRICKS_AUTH_STORAGE=plaintext and re-run login.
  

  Ejecute databricks auth login para resolverlo.

• Error en la comprobación de almacenamiento seguro al iniciar sesión Durante databricks auth login, la CLI de Databricks comprueba el almacenamiento seguro antes de iniciar el flujo de OAuth. Si se produce un error en la comprobación (lo más común en contenedores de Linux, sesiones SSH, WSL1 y servidores sin encabezado en los que D-Bus no se está ejecutando), el comportamiento depende de si se configuró explícitamente el almacenamiento seguro:

  • Modo predeterminado, sin configuración de almacenamiento explícita: la CLI de Databricks retrocede silenciosamente al texto no cifrado y escribe auth_storage = plaintext en la [__settings__] sección de ~/.databrickscfg. Los comandos posteriores usan texto no cifrado sin volver a comprobar.
  • Modo seguro explícito (DATABRICKS_AUTH_STORAGE=secure o auth_storage = secure en el perfil de configuración): la CLI de Databricks devuelve un error que remite al DATABRICKS_AUTH_STORAGE=plaintext fallback.

  Si la comprobación supera el tiempo de espera en lugar de fallar directamente (por ejemplo, si el llavero está bloqueado pero accesible), la CLI de Databricks mantiene el backend del llavero y la solicitud del sistema operativo para desbloquearlo se ejecuta en paralelo con el flujo OAuth del navegador.

  Para confirmar qué modo de almacenamiento usa la CLI de Databricks después del inicio de sesión, ejecute databricks auth describe.

• No se puede acceder a la cadena de claves al leer un token almacenado. A diferencia de durante el inicio de sesión, la CLI de Databricks no retroceda silenciosamente cuando no puede llegar a la cadena de claves en tiempo de lectura del token. Por ejemplo, si ha iniciado sesión en un equipo de escritorio y, a continuación, se ha conectado a través de SSH en una sesión sin interfaz gráfica, los comandos que necesitan el token almacenado fallan con un error. Utiliza la alternativa de texto no cifrado para resolver esto. Consulte Usar la alternativa de texto sin formato.

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.