Solução de problemas da CLI do Databricks

nota

Databricks CLI O uso está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer provisionamento de Dados de Uso.

Use as informações a seguir para solucionar problemas com o site Databricks CLI.

Ativar registro

Se um comando falhar ou não produzir a saída esperada, o senhor pode usar o registro em log para ajudar a identificar o que pode ter dado errado. O senhor pode acessar log mensagens que o Databricks CLI emite sobre vários eventos de comando, avisos e erros. Para log essas mensagens, especifique as seguintes opções Databricks CLI comando:

Bandeira	Descrição
--log-file	Uma cadeia de caracteres que representa o arquivo para gravar a saída logs. Se esse sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format	text para gravar a saída logs em texto ou json para gravar a saída logs em JSON. Se esse sinalizador não for especificado, a saída logs será gravada como texto.
--log-level	Uma sequência de caracteres representando o nível de formato log . Os níveis de log válidos são error, warn, info, debug, trace e disabled. O nível default é disabled, o que significa que nada é registrado. --debug é equivalente a --log-level debug.

O comando de exemplo a seguir logs as mensagens de rastreamento para o comando especificado em um arquivo chamado databricks-cli.log no formato JSON .

Bash

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

Erro ao baixar Terraform

Uma key expirada em algumas versões da CLI do Databricks causa o seguinte erro ao executar databricks bundle deploy:

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

Para resolver esse erro, atualize o Databricks CLI para a versão mais recente com os patches aplicados, que atualiza o mecanismo de verificação para funcionar com uma key mais recente. Atualize para a versão corrigida que corresponde à sua versão secundária atual da CLI:

• Instalação binária : baixe a versão corrigida na página de versõesDatabricks CLI no GitHub.

• ConfiguraçãoCLI (como um script de instalação ou GitHub Actions): Atualize a versão na sua configuração para uma versão corrigida da página de lançamentos CLI Databricks no GitHub.

  Por exemplo, para usar 0.296.1 com o GitHub Actions:

  YAML

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

Erro nas credenciais armazenadas

A partir da versão 1.0.0 da CLI do Databricks, a CLI do Databricks armazena tokens de autenticação user-to-machine (U2M) no armazenamento seguro nativo do SO (chaveiro no macOS, Gerenciador de Credenciais no Windows, D-Bus Secret serviço no Linux) em vez de um arquivo JSON. Consulte Armazenamento de tokens. Se o seu fluxo de trabalho é construído sobre o arquivo JSON, ele não funcionará com o novo método de armazenamento e você poderá encontrar problemas nos seguintes cenários:

• Atualizado para GA, ainda não fez log in novamente. A CLI do Databricks não lê mais as credenciais armazenadas por versões anteriores e retorna um erro:

  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.

  Executar databricks auth login para resolver isso.

• Falha na verificação de armazenamento seguro ao fazer login Durante databricks auth login, a CLI do Databricks verifica o armazenamento seguro antes de iniciar o fluxo OAuth. Se a verificação falhar (mais comum em contêineres Linux, sessões SSH, WSL1 e servidores headless onde o D-Bus não está sendo executado), o comportamento dependerá se o armazenamento seguro foi explicitamente configurado:

  • Modo default, nenhuma configuração explícita de armazenamento: a CLI do Databricks silenciosamente retorna a texto simples e grava auth_storage = plaintext na seção [__settings__] de ~/.databrickscfg. Os comandos subsequentes usam texto simples sem nova verificação.
  • Modo seguro explícito (DATABRICKS_AUTH_STORAGE=secure ou auth_storage = secure no perfil de configuração): A CLI do Databricks retorna um erro apontando para o DATABRICKS_AUTH_STORAGE=plaintext fallback.

  Se a verificação atingir o tempo limite em vez de falhar completamente (por exemplo, o chaveiro está bloqueado, mas acessível), a CLI do Databricks mantém o back-end do chaveiro e o prompt de desbloqueio do SO executa em paralelo com o fluxo de OAuth do navegador.

  Para confirmar qual modo de armazenamento a CLI do Databricks está usando após o login, execute databricks auth describe.

• Chaveiro não acessível ao ler um token armazenado. Diferentemente do que ocorre durante o login, a CLI do Databricks não faz fallback silenciosamente quando não consegue acessar o chaveiro no momento da leitura do token. Por exemplo, se você fez log in em uma máquina desktop e então se conectou via SSH em uma sessão headless, os comandos que precisam do token armazenado falham com um erro. O fallback de texto simples deve ser usado para resolver isso. Consulte Use o fallback de texto simples.

comando não terminando

Se você executar um comando como databricks cluster list e ele parecer travar, atualize sua versão do Databricks CLI para a versão mais recente. As versões anteriores da CLI tentavam carregar listas completas mesmo que o número de itens na lista fosse grande, e o comando parecia não terminar.