Problemen met de Databricks CLI oplossen

Notitie

Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.

Gebruik de volgende informatie om problemen met de Databricks CLI op te lossen.

Logboekregistratie inschakelen

Als een opdracht mislukt of de verwachte uitvoer niet produceert, kunt u logboekregistratie gebruiken om te bepalen wat er mogelijk mis is gegaan. U kunt berichten vastleggen die de Databricks CLI uitvoert over verschillende opdracht gebeurtenissen, waarschuwingen en fouten. Als u deze berichten wilt registreren, geeft u de volgende Opdrachtopties voor Databricks CLI op:

Vlag Beschrijving
--log-file Een tekenreeks die het bestand aangeeft waar uitvoerlogboeken naar moeten worden geschreven. Als deze vlag niet is opgegeven, is het standaardinstelling om uitvoerlogboeken naar stderr te schrijven.
--log-format text om uitvoerlogboeken naar tekst te schrijven of json uitvoerlogboeken naar JSON te schrijven. Als deze vlag niet is opgegeven, worden uitvoerlogboeken geschreven als tekst.
--log-level Een tekenreeks die het niveau van de logboekindeling vertegenwoordigt. Geldige logboekniveaus zijn error, warn, info, debug, trace en disabled. Het standaardniveau is disabled, wat betekent dat er niets wordt geregistreerd. --debug is equivalent aan --log-level debug.

In het volgende voorbeeld worden traceringsberichten voor de opgegeven opdracht in een bestand met de naam databricks-cli.log in JSON-indeling vastgelegd.

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

Fout bij het downloaden van Terraform

Een verlopen sleutel in sommige versies van de Databricks CLI veroorzaakt de volgende fout bij het uitvoeren databricks bundle deploy:

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

Als u deze fout wilt oplossen, werkt u de Databricks CLI bij naar een nieuwste versie met patches, waarmee het verificatiemechanisme wordt bijgewerkt om met een nieuwere sleutel te werken. Voer een upgrade uit naar de gepatchte versie die overeenkomt met uw huidige secundaire CLI-versie:

  • Binary install: Download de patchversie van de Databricks CLI-releasespagina op GitHub.

  • setup-cli (als installatiescript of GitHub-actie): Werk de versie in uw configuratie bij naar een patchversie vanaf de Databricks CLI-releasespagina op GitHub.

    Als u bijvoorbeeld 0.296.1 wilt gebruiken met de actie GitHub:

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

Fout bij opgeslagen referenties

Vanaf Databricks CLI versie 1.0.0 slaat de Databricks CLI verificatietokens (U2M) op in systeemeigen beveiligde opslag van het besturingssysteem (sleutelhanger in macOS, Credential Manager op Windows, D-Bus Secret Service op Linux) in plaats van een JSON-bestand. Zie Tokenopslag. Als uw werkstroom voortbouwt op het JSON-bestand, werkt dit niet tegen de nieuwe opslagmethode en kunnen er problemen optreden in de volgende scenario's:

  • Bijgewerkt naar algemeen beschikbaar, nog niet opnieuw aangemeld. De Databricks CLI leest geen referenties meer die zijn opgeslagen door oudere versies en retourneert een fout:

    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.

    Voer databricks auth login deze opdracht uit om dit op te lossen.

  • Beveiligde opslagcontrole mislukt bij aanmelding Tijdens databricks auth loginde Databricks CLI wordt de beveiligde opslag gecontroleerd voordat de OAuth-stroom wordt gestart. Als de controle mislukt (meestal in Linux-containers, SSH-sessies, WSL1 en headless servers waarop D-Bus niet wordt uitgevoerd), is het gedrag afhankelijk van of beveiligde opslag expliciet is geconfigureerd:

    • Standaardmodus, geen expliciete opslaginstelling: de Databricks CLI valt op de achtergrond terug op tekst zonder opmaak en schrijft auth_storage = plaintext naar de [__settings__] sectie van ~/.databrickscfg. Daaropvolgende opdrachten gebruiken platte tekst zonder opnieuw te controleren.
    • Expliciete beveiligde modus (DATABRICKS_AUTH_STORAGE=secure of auth_storage = secure in het configuratieprofiel): de Databricks CLI retourneert een fout die verwijst naar de DATABRICKS_AUTH_STORAGE=plaintext terugval.

    Als de controle een time-out krijgt in plaats van direct te mislukken (bijvoorbeeld omdat de keychain vergrendeld maar wel bereikbaar is), blijft de Databricks CLI de keychain-back-end gebruiken en loopt de OS-prompt voor ontgrendeling parallel aan het OAuth-proces in de browser.

    Voer databricks auth describe uit om te controleren welke opslagmodus de Databricks CLI gebruikt na aanmelding.

  • Sleutelhanger is niet bereikbaar bij het lezen van een opgeslagen token. In tegenstelling tot bij het aanmelden valt de Databricks CLI niet stilzwijgend terug wanneer deze de sleutelhanger niet kan bereiken bij het lezen van het token. Als u bijvoorbeeld op een desktopcomputer hebt ingelogd en vervolgens via SSH verbinding hebt gemaakt in een headless-sessie, mislukken opdrachten die het opgeslagen token nodig hebben met een foutmelding. Gebruik de terugvaloptie voor platte tekst om dit op te lossen. Zie Use the plaintext fallback.

Opdrachten worden niet afgemaakt

Als u een opdracht uitvoert zoals databricks cluster list en deze lijkt vast te lopen, werkt u uw versie van de Databricks CLI bij naar de meest recente versie. Eerdere versies van de CLI proberen volledige lijsten te laden, zelfs als het aantal items in de lijst groot was en de opdracht niet zou worden voltooid.

  • Last updated on