Řešení problémů s příkazovým řádkem Databricks

Poznámka:

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Při řešení problémů s rozhraním příkazového řádku Databricks použijte následující informace.

Povolit protokolování

Pokud příkaz selže nebo nevygeneruje očekávaný výstup, můžete pomocí protokolování zjistit, co se mohlo pokazit. Můžete protokolovat zprávy, které rozhraní příkazového řádku Databricks vypíše o různých událostech příkazů, upozorněních a chybách. Pokud chcete tyto zprávy protokolovat, zadejte následující možnosti příkazu rozhraní příkazového řádku Databricks:

Příznak	Popis
--log-file	Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.
--log-format	text k zápisu výstupních protokolů do textu nebo json k zápisu výstupních protokolů do FORMÁTU JSON. Pokud tento příznak není zadaný, výstupní protokoly se zapíšou jako text.
--log-level	Řetězec představující úroveň formátu protokolu. Platné úrovně protokolu jsou error, , warninfodebug, , trace, a disabled. Výchozí úroveň je disabled, což znamená, že se nic nezaloguje. --debug je ekvivalent --log-level debug.

Následující příklad příkazu zaznamená trasovací zprávy pro zadaný příkaz do souboru pojmenovaného databricks-cli.log ve formátu JSON.

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

Chyba při stahování Terraformu

Platnost klíče vypršela v některých verzích rozhraní příkazového řádku Databricks, která při spuštění databricks bundle deployzpůsobí následující chybu:

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

Pokud chcete tuto chybu vyřešit, upgradujte rozhraní příkazového řádku Databricks na nejnovější opravenou verzi, která aktualizuje ověřovací mechanismus pro práci s novějším klíčem. Upgradujte na opravenou verzi, která odpovídá vaší aktuální podverzi rozhraní příkazového řádku:

• Binární instalace: Stáhněte opravenou verzi ze stránky s verzemi Databricks CLI na GitHub.

• setup-cli (jako instalační skript nebo akce GitHub): Aktualizujte verzi v konfiguraci na opravenou verzi ze stránky Databricks CLI releases na GitHub.

  Pokud chcete například použít 0.296.1 s akcí GitHub:

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

Chyba uložených přihlašovacích údajů

Počínaje rozhraním příkazového řádku Databricks verze 1.0.0 ukládá rozhraní příkazového řádku Databricks ověřovací tokeny uživatele na počítač (U2M) v zabezpečeném úložišti nativním pro operační systém (klíčenky v systému macOS, Správce přihlašovacích údajů ve službě Windows, tajné službě D-Bus v Linuxu) místo souboru JSON. Viz Úložiště tokenů. Pokud se váš pracovní postup sestaví nad souborem JSON, nebude fungovat s novou metodou úložiště a v následujících scénářích může dojít k problémům:

• Upgradováno na verzi GA, ale zatím bez nového přihlášení. Rozhraní příkazového řádku Databricks už nečte přihlašovací údaje uložené ve starších verzích a vrací chybu:

  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.
  

  Spusťte databricks auth login, abyste tento problém vyřešili.

• Při přihlášení selže kontrola zabezpečeného úložiště Během databricks auth loginobdobí zkontroluje rozhraní příkazového řádku Databricks zabezpečené úložiště před spuštěním toku OAuth. Pokud se kontrola nezdaří (nejběžnější v linuxových kontejnerech, relacích SSH, WSL1 a bezobrazových serverech, ve kterých není spuštěná D-Bus), chování závisí na tom, jestli bylo explicitně nakonfigurované zabezpečené úložiště:

  • Výchozí režim, bez explicitního nastavení úložiště: Databricks CLI tiše přejde na ukládání v prostém textu a zapíše auth_storage = plaintext do oddílu [__settings__] v souboru ~/.databrickscfg. Následující příkazy používají prostý text bez opakované kontroly.
  • Explicitní zabezpečený režim (DATABRICKS_AUTH_STORAGE=secure nebo auth_storage = secure v konfiguračním profilu): Databricks CLI vrátí chybu s odkazem na záložní možnost DATABRICKS_AUTH_STORAGE=plaintext.

  Pokud při kontrole vyprší časový limit místo toho, aby rovnou selhala (například když je klíčenka uzamčená, ale dostupná), Databricks CLI ponechá backend klíčenky a výzva systému k odemknutí se spustí paralelně s procesem OAuth v prohlížeči.

  Pokud chcete ověřit, jaký režim úložiště rozhraní příkazového řádku Databricks používá po přihlášení, spusťte databricks auth describepříkaz .

• Klíčenky nejsou dostupné při čtení uloženého tokenu. Na rozdíl od přihlášení se rozhraní příkazového řádku Databricks bezobslužně nevrací, když se nemůže spojit se řetězcem klíčů v době čtení tokenu. Pokud jste se například přihlásili na stolním počítači a pak jste se připojili přes SSH v bezobrátové relaci, příkazy, které potřebují uložený token, selžou s chybou. Použijte záložní variantu v podobě prostého textu k vyřešení tohoto problému. Viz Použití náhradního textu ve formátu prostého textu.

Příkazy se nedokončují

Pokud spustíte příkaz, například databricks cluster list a zdá se, že přestane reagovat, aktualizujte verzi rozhraní příkazového řádku Databricks na nejnovější verzi. Starší verze rozhraní příkazového řádku by se pokusily načíst úplné seznamy, i když byl počet položek v seznamu velký a příkaz by se zdá, že se nedokončí.