Risolvere i problemi della CLI di Databricks

Nota

L'uso del CLI di Databricks è soggetto alla Licenza Databricks e all'Informativa sulla Privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

Usare le informazioni seguenti per risolvere i problemi relativi all'interfaccia della riga di comando di Databricks.

Abilitazione della registrazione

Se un comando ha esito negativo o non produce l'output previsto, è possibile usare la registrazione per identificare gli errori. È possibile registrare i messaggi restituiti dall'interfaccia della riga di comando di Databricks relativi a vari eventi di comando, avvisi ed errori. Per registrare questi messaggi, specificare le opzioni di comando dell'interfaccia della riga di comando di Databricks seguenti:

Segnale	Descrizione
--log-file	Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.
--log-format	text per scrivere i log di output in testo o json per scrivere i log di output in JSON. Se questo flag non viene specificato, i log di output vengono scritti come testo.
--log-level	Stringa che rappresenta il livello di formato del log. I livelli di log validi sono error, warn, infodebug, , tracee disabled. Il livello predefinito è disabled, il che significa che non viene registrato nulla. --debug è pari a --log-level debug.

Il comando di esempio seguente registra i messaggi di traccia per il comando specificato in un file denominato databricks-cli.log in formato JSON.

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

Errore durante il download di Terraform

Una chiave scaduta in alcune versioni della CLI di Databricks causa l'errore seguente durante l'esecuzione di databricks bundle deploy:

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

Per risolvere questo errore, aggiornare l'interfaccia della riga di comando di Databricks a una versione più recente con patch, che aggiorna il meccanismo di verifica per l'uso con una chiave più recente. Aggiorna alla versione con patch corrispondente alla tua attuale versione minore della CLI:

• Binary install: scaricare la versione con patch dalla pagina delle versioni dell'interfaccia della riga di comando di Databricks in GitHub.

• setup-cli (come script di installazione o azione GitHub): aggiorna la versione nella configurazione a una versione corretta dalla pagina delle release di Databricks su GitHub.

  Ad esempio, per usare 0.296.1 con l'azione GitHub:

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

Errore delle credenziali archiviate

A partire dall'interfaccia della riga di comando di Databricks versione 1.0.0, l'interfaccia della riga di comando di Databricks archivia i token di autenticazione da utente a computer (U2M) nell'archiviazione sicura nativa del sistema operativo (keychain in macOS, Credential Manager in Windows, Servizio segreto D-Bus in Linux) anziché in un file JSON. Vedere Archiviazione dei token. Se il flusso di lavoro si basa sul file JSON, non funzionerà con il nuovo metodo di archiviazione e potrebbero verificarsi problemi negli scenari seguenti:

• Aggiornato alla disponibilità generale, senza aver ancora effettuato di nuovo l'accesso. L'interfaccia della riga di comando di Databricks non legge più le credenziali archiviate dalle versioni precedenti e restituisce un errore:

  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.
  

  Eseguire databricks auth login per risolvere il problema.

• Il controllo dell'archiviazione sicura non riesce all'accesso Durante databricks auth login, l'interfaccia della riga di comando di Databricks controlla l'archiviazione sicura prima di avviare il flusso OAuth. Se il controllo ha esito negativo (più comune nei contenitori Linux, sessioni SSH, WSL1 e server headless in cui D-Bus non è in esecuzione), il comportamento dipende dal fatto che l'archiviazione sicura sia stata configurata in modo esplicito:

  • Modalità predefinita, nessuna impostazione di archiviazione esplicita: l'interfaccia della riga di comando di Databricks esegue automaticamente il fallback al testo non crittografato e scrive auth_storage = plaintext nella [__settings__] sezione di ~/.databrickscfg. I comandi successivi usano testo non crittografato senza ricontrollare.
  • Modalità sicura esplicita (DATABRICKS_AUTH_STORAGE=secure o auth_storage = secure nel profilo di configurazione): la CLI di Databricks restituisce un errore che rimanda al fallback DATABRICKS_AUTH_STORAGE=plaintext.

  Se il controllo va in timeout invece di fallire del tutto (ad esempio, il keychain è bloccato ma raggiungibile), la CLI di Databricks mantiene il backend del keychain e il prompt di sblocco del sistema operativo si esegue in parallelo con il flusso OAuth del browser.

  Per verificare la modalità di archiviazione usata dall'interfaccia della riga di comando di Databricks dopo l'accesso, eseguire databricks auth describe.

• Keychain non raggiungibile durante la lettura di un token archiviato. Diversamente da quanto avviene durante l'accesso, la CLI di Databricks non ricorre automaticamente al fallback quando non riesce ad accedere al portachiavi durante la lettura del token. Ad esempio, se hai effettuato l'accesso da un computer desktop e poi ti sei connesso tramite SSH in una sessione senza interfaccia grafica, i comandi che richiedono il token archiviato non riescono e restituiscono un errore. Usare l'alternativa di testo non crittografato per risolvere il problema. Consulta Utilizzare il fallback del testo normale.

Comandi non completati correttamente

Se si esegue un comando come databricks cluster list e sembra bloccarsi, aggiornare la versione dell'interfaccia della riga di comando di Databricks alla versione più recente. Le versioni precedenti dell'interfaccia della riga di comando tentano di caricare elenchi completi anche se il numero di elementi nell'elenco è di grandi dimensioni e il comando sembra non terminare.