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
parancscsoport a Databricks CLI felületén lehetővé teszi a Databricks CLI hitelesítését az Azure Databricks-szel, Azure Databricks személyes hozzáférési jogkivonatok vagy Microsoft Entra ID (korábbi nevén Azure Active Directory) jogkivonatok használatával.
Megjegyzé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ásnevekhez tartozó jogkivonatok létrehozásáról, lásd szolgáltatásnév jogkivonatainak kezelése.
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.
Az configure
parancsokat az databricks configure
-hez hozzáfűzve futtathatja. 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
: , DEV
vagy PROD
.
Konfigurációs profil létrehozásához futtassa a configure
következő parancsot:
databricks configure --host <workspace-url>
Az <workspace-url>
esetében adja meg a munkaterületenkénti URL-címet a https://adb-<workspace-id>.<random-number>.azuredatabricks.net
formátumban. 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 ~/.databrickscfg
Windows rendszeren tárolja a fájlban%USERPROFILE%\.databrickscfg
. A fájl a következő nevű alapértelmezett kapcsolatprofil-bejegyzést DEFAULT
tartalmazza:
[DEFAULT]
host = <workspace-url>
token = <access-token>
Ha a kapcsolatprofil számára egy másik nevet szeretne használni DEFAULT
helyett, adja hozzá a --profile
opciót a configure
parancshoz, például:
databricks configure --host <workspace-url> --profile <profile-name>
Tipp.
A Tab
--profile
vagy -p
után lenyomva megjelenítheti a választható meglévő konfigurációs profilok listáját ahelyett, hogy manuálisan adja meg a konfigurációs profil nevét.
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_FILE
beá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.