A Databricks parancssori felületének oktatóanyaga

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:

• Linux vagy macOS esetén a Homebrew telepítve van.

  Feljegyzés

  Ha nem tudja használni a Homebrew-t, a parancssori felület telepítésének egyéb módjaiért lásd: A Databricks parancssori felületének telepítése vagy frissítése.

• Windows esetén winget, Chocolatey vagy Linuxos Windows-alrendszer (WSL) van telepítve. A telepítési utasításokért tekintse meg az operációs rendszer dokumentációját.

  Feljegyzés

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

  Ha nem tudja winget, Chocolatey vagy WSL használatával telepíteni a parancssori felületet, olvassa el A Databricks parancssori felületénektelepítése vagy frissítése című témakört.

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 databricks futtat, de hibaüzenetet kap, például command not found: databricks, vagy ha databricks -v futtat, é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ő 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:

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:

   • Cserélje le <account-console-url> az Azure Databricksre https://accounts.azuredatabricks.net.
   • Cserélje le <account-id> az Azure Databricks-fiók azonosítójára. Lásd: A fiókazonosító megkeresése.

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

   Munkaterületszintű műveletek esetén

   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 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 Databricks parancssori felületének beállítása után:

• 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.