Megosztás:


A Databricks parancssori felületének oktatóanyaga

Feljegyzés

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak. A Databricks parancssori felülete nyilvános előzetes verzióban érhető el.

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ülete (más néven Databricks CLI) egy könnyen használható felületet biztosít az Azure Databricks platform automatizálásához a terminálról, parancssorból vagy automatizálási szkriptekből. Lásd: Mi a Databricks parancssori felület?

Ez a cikk bemutatja, hogyan telepítheti és konfigurálhatja gyorsan a Databricks parancssori felületét.

Helyi gép követelményeinek megerősítése

Ez az oktatóanyag a következőket feltételezi:

A Databricks parancssori felületének telepítése

  1. Telepítse a Databricks parancssori felületét:

    Linux, macOS

    A Következő két parancs futtatásával telepítse a Databricks parancssori felületet a Homebrew használatával:

    brew tap databricks/tap
    brew install databricks
    

    Windows

    A Databricks parancssori felület telepítéséhez használhatja a winget, a Chocolatey vagy a Windows-alrendszer a Linuxhoz (WSL) eszközöket. Ha nem tudja használni a winget, Chocolatey-t vagy a WSL-t, hagyja ki ezt az eljárást, és a Command Prompt vagy a PowerShell segítségével telepítse a Databricks CLI-t a forrásból.

    Feljegyzés

    A Databricks CLI és a Chocolatey telepítése kísérleti.

    winget A Databricks parancssori felület telepítéséhez futtassa a következő két parancsot, majd indítsa újra a parancssort:

    winget search databricks
    winget install Databricks.DatabricksCLI
    

    A Databricks parancssori felület telepítéséhez futtassa a következő parancsot a Chocolatey használatával:

    choco install databricks-cli
    

    A WSL használata a Databricks parancssori felület telepítéséhez:

    1. Telepítse curl és zip a WSL-en keresztül. További információkért tekintse meg az operációs rendszer dokumentációját.

    2. A következő parancs futtatásával telepítse a Databricks CLI-t a WSL használatával:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
      
  2. Ellenőrizze, hogy a Databricks parancssori felület telepítve van-e a következő parancs futtatásával, amely megjeleníti a telepített Databricks parancssori felület aktuális verzióját. Ennek a verziónak a 0.205.0-s vagy újabb verziónak kell lennie:

    databricks -v
    

A munkaterülethez való hozzáférés konfigurálása

Ezután konfigurálja a Databricks-munkaterülethez való hozzáférést.

Feljegyzés

Ez az oktatóanyag OAuth felhasználó–gép (U2M) hitelesítéssel hitelesíti a parancssori felületet az Azure Databricks felhasználói fiókjával. Ha a parancssori felületet más Databricks-hitelesítési típusok használatára szeretné konfigurálni, tekintse meg a Databricks parancssori felület hitelesítését.

  1. A Databricks parancssori felületével helyileg kezdeményezheti az OAuth-jogkivonatok kezelését az egyes célfiókok vagy munkaterületek következő parancsának futtatásával.

    Fiókszintű műveletek esetén a következő parancsban cserélje le a következő helyőrzőket:

    databricks auth login --host <account-console-url> --account-id <account-id>
    

    Munkaterületszintű műveletek esetén a következő parancsban cserélje le a az Azure Databricks <workspace-url>, például .

    databricks auth login --host <workspace-url>
    
  2. A Databricks parancssori felülete kéri, hogy mentse az Azure Databricks konfigurációs profiljaként megadott adatokat. Nyomja meg a Enter gombot a javasolt profilnév elfogadásához, vagy adjon meg egy új vagy meglévő profilnevet. Az azonos nevű meglévő profilokat felülírja a megadott adatokkal. Profilokkal gyorsan válthat a hitelesítési környezet között több fiók vagy munkaterület között.

    A meglévő profilok listájának lekéréséhez egy külön terminálban vagy parancssorban futtassa a Databricks parancssori felületét a parancs databricks auth profilesfuttatásához. Egy adott profil meglévő beállításainak megtekintéséhez futtassa a parancsot databricks auth env --profile <profile-name>.

  3. A webböngészőben végezze el a képernyőn megjelenő utasításokat az Azure Databricks-fiókba vagy -munkaterületre való bejelentkezéshez.

  4. A profil aktuális OAuth-tokenértékének és a jogkivonat közelgő lejárati időbélyegének megtekintéséhez futtassa az alábbi parancsok egyikét:

    Fiókszintű műveletek esetén futtassa a következő parancsokat:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Ha több azonos --host és --account-id értékkel rendelkező profillal rendelkezik, előfordulhat, hogy meg kell adnia a --host, --account-idés -p beállításokat, hogy a Databricks parancssori felület megtalálja a megfelelő OAuth-jogkivonat-információkat.

    Munkaterületszintű műveletek esetén futtassa a következő parancsokat:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Ha több profilja is ugyanazokkal a --host értékekkel rendelkezik, előfordulhat, hogy együtt kell megadnia a --host és -p beállításokat, hogy a Databricks parancssori felülete megkeresse a megfelelő OAuth-jogkivonat adatait.

Következő lépések

  • A parancssori felület használatának megismeréséhez tekintse meg a Databricks parancssori felület alapszintű használatát.
  • Az elérhető parancssori felületi parancsok áttekintését a Databricks CLI-parancsok című témakörben tekintheti meg.
  • Ha a parancssori felület nem fut, vagy váratlan eredményeket hoz létre, olvassa el a parancssori felület telepítésének ellenőrzése című témakört.