A Databricks parancssori felületének hibaelhárítása

Megjegyzés

A Databricks CLI használatára a Databricks Licenc és a Databricks adatvédelmi nyilatkozata vonatkozik, beleértve a használati adatokra vonatkozó rendelkezéseket is.

A Databricks parancssori felületével kapcsolatos problémák elhárításához használja az alábbi információkat.

Naplózás engedélyezése

Ha egy parancs meghiúsul, vagy nem hozza létre a várt kimenetet, a naplózással azonosíthatja, hogy mi lehet a hiba. Naplózhatja azokat az üzeneteket, amelyeket a Databricks CLI különböző parancseseményekről, figyelmeztetésekről és hibákról ad ki. Az üzenetek naplózásához adja meg a következő Databricks CLI-parancsbeállításokat:

Zászló	Leírás
--log-file	Egy szöveg, amely a fájlt jelképezi, amelybe a kimeneti naplókat kell írni. Ha ez a jelző nincs megadva, akkor az alapértelmezett beállítás a kimeneti naplók stderrbe írása.
--log-format	text a kimeneti naplók szövegbe írásához vagy json a kimeneti naplók JSON-ba való írásához. Ha ez a jelző nincs megadva, a kimeneti naplók szövegként lesznek megírva.
--log-level	A naplóformátum szintjét képviselő karakterlánc. Az érvényes naplószintek a következőkerror: , warninfo, , debugtraceés disabled. Az alapértelmezett szint az disabled, ami azt jelenti, hogy a rendszer semmit sem naplóz. --debugegyenértékű a .-nak.--log-level debug

Az alábbi példaparancs naplózza a megadott parancs nyomkövetési üzeneteit egy JSON formátumban elnevezett databricks-cli.log fájlba.

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

Hiba a Terraform letöltésekor

A Databricks parancssori felület egyes verzióiban a lejárt kulcs a következő hibát okozza a futtatáskor databricks bundle deploy:

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

A hiba megoldásához frissítse a Databricks parancssori felületét egy legújabb javított verzióra, amely frissíti az ellenőrzési mechanizmust, hogy egy újabb kulccsal működjön. Frissítsen az aktuális CLI-alverziónak megfelelő javított verzióra:

• Binary telepítése: Töltse le a javított verziót a Databricks CLI kiadási oldaláról GitHub.

• setup-cli (telepítési szkriptként vagy GitHub műveletként): Frissítse a konfigurációban lévő verziót egy javított verzióra a Databricks CLI kiadási oldaláról GitHub.

  Például a 0.296.1 a GitHub Művelettel való használatához:

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

Tárolt hitelesítő adatokkal kapcsolatos hiba

A Databricks CLI 1.0.0-s verziójától kezdődően a Databricks CLI JSON-fájl helyett az operációs rendszer natív biztonságos tárolójában tárolja a felhasználó–gép közötti (U2M) hitelesítési jogkivonatokat (kulcskarika macOS rendszeren, Credential Manager Windows, D-Bus Secret Service Linux rendszeren). Lásd: Token Storage. Ha a munkafolyamat a JSON-fájlra épül, az nem fog működni az új tárolási módszer ellen, és a következő helyzetekben problémák léphetnek fel:

• GA-ra frissítve, még nem jelentkezett be újra. A Databricks parancssori felülete már nem olvassa be a régebbi verziók által tárolt hitelesítő adatokat, és hibát ad vissza:

  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.
  

  Futtassa a(z) databricks auth login elemet a probléma megoldásához.

• A biztonságos tároló ellenőrzése sikertelen a bejelentkezéskor A databricks auth login során a Databricks CLI az OAuth-folyamat elindítása előtt ellenőrzi a biztonságos tárolót. Ha az ellenőrzés sikertelen (leggyakrabban Linux-tárolókban, SSH-munkamenetekben, WSL1- és fej nélküli kiszolgálókon, ahol a D-Bus nem fut), a viselkedés attól függ, hogy a biztonságos tároló explicit módon lett-e konfigurálva:

  • Alapértelmezett mód, nincs explicit tárolási beállítás: a Databricks parancssori felület csendesen visszaesik a egyszerű szövegre, és beírja auth_storage = plaintext a [__settings__] szakaszba ~/.databrickscfg. A következő parancsok egyszerű szöveget használnak újraellenőrzés nélkül.
  • Kifejezetten beállított biztonságos mód (DATABRICKS_AUTH_STORAGE=secure vagy auth_storage = secure a konfigurációs profilban): a Databricks CLI a DATABRICKS_AUTH_STORAGE=plaintext fallbackra mutató hibát jelez.

  Ha az ellenőrzés nem azonnali hibával áll le, hanem időtúllépés történik (például a kulcstartó zárolva van, de elérhető), a Databricks CLI megtartja a kulcstartó-háttérrendszert, és az operációs rendszer feloldási kérőablaka a böngészős OAuth-folyamattal párhuzamosan fut.

  Annak ellenőrzéséhez, hogy a Databricks CLI milyen tárolási módot használ bejelentkezés után, futtassa a következőt databricks auth describe: .

• A kulcskarika nem érhető el tárolt jogkivonat olvasásakor. A bejelentkezéssel ellentétben a Databricks CLI nem vált át automatikusan, ha a token olvasásakor nem éri el a kulcstartót. Ha például bejelentkezett egy asztali gépen, majd egy fej nélküli munkamenetben csatlakozott az SSH-hoz, a tárolt jogkivonatot igénylő parancsok hiba miatt meghiúsulnak. A probléma megoldásához használja az egyszerű szöveges tartalékmegoldást. Lásd: Az egyszerű szöveges tartalékmegoldás használata.

A parancsok nem fejeződnek be

Ha egy parancsot, például databricks cluster list, futtat, és úgy tűnik, hogy elakadni látszik, frissítse a Databricks CLI-t annak legújabb verziójára. A parancssori felület korábbi verziói akkor is megpróbálják betölteni a teljes listákat, ha a listában szereplő elemek száma nagy volt, és úgy tűnik, hogy a parancs nem fejeződik be.