configure parancscsoport

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 configure Databricks parancssori felületén található parancscsoport lehetővé teszi a Databricks PARANCSSOR azure Databricks-beli hitelesítését azure Databricks-beli személyes hozzáférési jogkivonatok vagy Microsoft Entra-azonosító (korábbi nevén Azure Active Directory-) jogkivonatok használatával.

Feljegyzés

Ajánlott biztonsági eljárásként, ha automatizált eszközökkel, rendszerekkel, szkriptekkel és alkalmazásokkal hitelesít, a Databricks azt javasolja, hogy munkaterület-felhasználók helyett a szolgáltatásnevekhez tartozó személyes hozzáférési jogkivonatokat használja. A szolgáltatásnevek jogkivonatainak létrehozásáról a szolgáltatásnév jogkivonatainak kezelése című témakörben olvashat.

Vegye figyelembe, hogy ez a cikk csak az Azure Databricks személyes hozzáférési jogkivonatát és a Microsoft Entra ID token-hitelesítést ismerteti a munkaterületszintű parancsok hívásának engedélyezéséhez. További hitelesítési konfigurációs beállításokért tekintse meg a Databricks parancssori felület hitelesítését.

Fontos

A parancs futtatása előtt mindenképpen állítsa be a Databricks parancssori felületét.

Parancsokat a parancsok hozzáfűzésével futtathat configure databricks configure. A parancs súgójának megjelenítéséhez futtassa a configure parancsot databricks configure -h.

Konfigurációs profil létrehozása

A konfigurációs profilok olyan beállítások gyűjteményei, amelyek olyan hitelesítési információkat tartalmaznak, mint az Azure Databricks-munkaterület URL-címe és a hozzáférési jogkivonat értéke. A konfigurációs profilnak programozott neve van, például DEFAULT: , DEVvagy PROD.

Konfigurációs profil létrehozásához futtassa a configure következő parancsot:

databricks configure --host <workspace-url>

Ehhez <workspace-url>adja meg a munkaterületenkénti URL-címet a formátummal https://adb-<workspace-id>.<random-number>.azuredatabricks.net. A munkaterületenkénti URL-cím lekéréséhez tekintse meg a munkaterületenkénti URL-címet.

A parancssor arra kéri, hogy adja meg az Azure Databricks személyes hozzáférési jogkivonatát vagy a Microsoft Entra ID (korábbi nevén Azure Active Directory) jogkivonatát , amely megfelel a megadottnak <workspace-url>:

✔ Databricks Token:

A hozzáférési jogkivonat megadása után a hozzáférési jogkivonatot a rendszer alapértelmezés szerint Linuxon vagy macOS rendszeren, illetve %USERPROFILE%\.databrickscfg Windows rendszeren tárolja a fájlban~/.databrickscfg. A fájl a következő nevű alapértelmezett kapcsolatprofil-bejegyzést DEFAULTtartalmazza:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Ha a kapcsolatprofil DEFAULThelyett más nevet szeretne használni, adja hozzá a --profile configure parancsot, például:

databricks configure --host <workspace-url> --profile <profile-name>

Tipp.

A konfigurációs profil nevének manuális megadása helyett a Tab --profile -p meglévő elérhető konfigurációs profilok listáját is lenyomhatja vagy megjelenítheti.

A megadott kapcsolati profilon belüli meglévő gazdagép- és jogkivonat-információk felülíródnak az új gazdagép és a jogkivonat adataival.

Több kapcsolatprofil hozzáadása a fájlhoz lehetővé teszi a .databrickscfg parancsok gyors futtatását különböző munkaterületeken a célkapcsolati profil nevének megadásával a parancs --profile beállításában. Ha nem adja meg a --profile beállítást egy olyan parancsban, amely támogatja ezt a beállítást, a parancs alapértelmezés szerint a DEFAULT kapcsolati profilt használja.

Létrehozhat például egy kapcsolatprofilt DEV , amely egy fejlesztési számítási feladatokhoz használt Azure Databricks-munkaterületre hivatkozik, és egy külön kapcsolatprofil nevesített PROD kapcsolatprofilra, amely egy másik Azure Databricks-munkaterületre hivatkozik, amelyet éles számítási feladatokhoz használ.

A fájl alapértelmezett elérési útját .databrickscfg a környezeti változó DATABRICKS_CONFIG_FILEbeállításával módosíthatja. A környezeti változók beállításának megismeréséhez tekintse meg az operációs rendszer dokumentációját.

A meglévő konfigurációs profilokkal kapcsolatos információkért használja a hitelesítési parancscsoportot.