A Databricks parancssori felületének oktatóanyaga

  • Cikk

Feljegyzés

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak, amelyek nyilvános előzetes verzióban érhetők el. A Databricks parancssori felület verziójának megkereséséhez futtassa a következőt databricks -v: .

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.

Ez a cikk bemutatja, hogyan használhatja a helyi fejlesztőgépet a Databricks parancssori felületének gyors használatbavételéhez. Lásd: Mi a Databricks parancssori felület?

A következő gyakorlati oktatóanyag feltételezi:

Végezze el a következő lépéseket:

  1. Ha még nincs telepítve, telepítse a Databricks parancssori felületét az alábbiak szerint:

    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álhat winget, Chocolatey vagy Linuxos Windows-alrendszer (WSL). Ha a Chocolatey vagy a WSL nem használható winget, hagyja ki ezt az eljárást, és a parancssor vagy a PowerShell használatával telepítse a Databricks PARANCSSOR-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 telepítse a zip WSL-t. 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 PARANCSSOR-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

    Feljegyzés

    Ha futtat, databricks de hibaüzenetet kap, például command not found: databricks, vagy ha fut databricks -v , és a 0.18-as vagy újabb verziószám jelenik meg, ez azt jelenti, hogy a gép nem találja a Databricks parancssori felületének megfelelő végrehajtható verzióját. A probléma megoldásához tekintse meg a parancssori felület telepítésének ellenőrzése című témakört.

A Databricks parancssori felület telepítése után hajtsa végre a következő lépéseket:

Feljegyzés

Ez az oktatóanyag feltételezi, hogy OAuth felhasználó–gép (U2M) hitelesítéssel szeretné hitelesíteni 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 <workspace-url> például https://adb-1234567890123456.7.azuredatabricks.netaz Azure Databricks munkaterületenkénti URL-címét.

    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 le Enter a javasolt profilnevet, vagy adja meg egy új vagy meglévő profil nevét. 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 Parancsot databricks auth profilesa Databricks parancssori felületével. 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 és --account-id értékekkel rendelkező profillal --host rendelkezik, előfordulhat, hogy együtt kell megadnia a --host, --account-idés -p a beállításokat, hogy a Databricks parancssori felülete megkeresse 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 --host az értékekkel rendelkezik, előfordulhat, hogy együtt kell megadnia a --host beállításokat, hogy -p a Databricks parancssori felülete megkeresse a megfelelő OAuth-tokenadatokat.

Következő lépések

A Databricks parancssori felületének beállítása után: