Solucionar problemas da CLI do Databricks

Nota

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

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

Ativar registo

Se um comando falhar ou não produzir a saída esperada, você poderá usar o log para ajudar a identificar o que pode ter dado errado. Você pode registrar mensagens que a CLI do Databricks gera sobre vários eventos de comando, avisos e erros. Para registrar essas mensagens, especifique as seguintes opções de comando da CLI do Databricks:

Sinalizador Descrição
--log-file Uma cadeia de caracteres que representa o arquivo para gravar logs de saída. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.
--log-format text para gravar logs de saída em texto ou json para gravar logs de saída em JSON. Se esse sinalizador não for especificado, os logs de saída serão gravados como texto.
--log-level Uma cadeia de caracteres que representa o nível de formato de log. Os níveis de logarítmica válidos são error, warn, info, debug, trace, e disabled. O nível padrão é disabled, o que significa que nada é registado. --debug é equivalente a --log-level debug.

O exemplo de comando seguinte regista mensagens de rastreamento para o comando especificado até um ficheiro nomeado databricks-cli.log em formato JSON.

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

Erro a descarregar o Terraform

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

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

Para resolver este erro, atualize a CLI Databricks para uma versão atualizada mais recente, que atualiza o mecanismo de verificação para funcionar com uma chave mais recente. Atualiza para a versão atualizada que corresponde à tua versão menor atual da CLI:

  • Binary install: Descarregue a versão corrigida na página de lançamentos da CLI Databricks no GitHub.

  • setup-cli (como um script de instalação ou Ação do GitHub): Atualize a versão na sua configuração para uma versão corrigida a partir da página de lançamentos do Databricks CLI no GitHub.

    Por exemplo, para usar 0.296.1 com a ação do GitHub:

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

Erro de credenciais armazenadas

A partir da CLI Databricks versão 1.0.0, a CLI Databricks armazena tokens de autenticação utilizador-máquina (U2M) em armazenamento seguro nativo do sistema operativo (chaveiro no macOS, Credential Manager no Windows, Serviço Secreto D-Bus no Linux) em vez de um ficheiro JSON. Ver Armazenamento de tokens. Se o seu fluxo de trabalho se basear no ficheiro JSON, não funcionará contra o novo método de armazenamento e poderá encontrar problemas nos seguintes cenários:

  • Atualizei para GA, ainda não voltei a iniciar sessão. A CLI Databricks já não lê credenciais armazenadas por versões anteriores e devolve 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.

    Executa databricks auth login para resolver isto.

  • Verificação de armazenamento seguro falha no início de sessão Durante databricks auth login, a CLI Databricks verifica o armazenamento seguro antes de iniciar o fluxo OAuth. Se a verificação falhar (mais comum em contentores Linux, sessões SSH, WSL1 e servidores headless onde o D-Bus não está a correr), o comportamento depende de o armazenamento seguro ter sido explicitamente configurado:

    • Modo padrão, sem configuração explícita de armazenamento: a CLI do Databricks recorre silenciosamente a texto simples e escreve auth_storage = plaintext na secção [__settings__] de ~/.databrickscfg. Os comandos subsequentes usam texto simples sem voltar a verificar.
    • Modo seguro explícito (DATABRICKS_AUTH_STORAGE=secure ou auth_storage = secure no perfil de configuração): a CLI Databricks devolve um erro que aponta para o DATABRICKS_AUTH_STORAGE=plaintext fallback.

    Se a verificação atingir o tempo limite em vez de falhar de imediato (por exemplo, se a keychain estiver bloqueada, mas acessível), a CLI do Databricks mantém o backend da keychain e o pedido de desbloqueio do sistema operativo é executado em paralelo com o fluxo OAuth no navegador.

    Para confirmar qual o modo de armazenamento que a CLI Databricks está a usar após iniciar sessão, execute databricks auth describe.

  • Keychain inacessível ao ler um token armazenado. Ao contrário do início de sessão, a CLI do Databricks não recua silenciosamente quando não consegue alcançar o keychain no momento da leitura do token. Por exemplo, se iniciaste sessão num computador de secretária e depois te ligaste via SSH numa sessão headless, os comandos que precisam do token armazenado falham com um erro. Use a alternativa em texto simples para resolver isto. Veja Utilizar a alternativa de texto simples.

Comandos não concluídos

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

  • Last updated on