configure parancs

Note

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 configureDatabricks CLI-n belüli parancs lehetővé teszi a Databricks parancssori felület azure Databricks-beli hitelesítését az Azure Databricks személyes hozzáférési jogkivonatai vagy a Microsoft Entra ID (korábbi nevén Azure Active Directory) jogkivonatok használatával.

Note

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. Szolgáltatási főszereplők jogkivonatainak létrehozásához lásd a Szolgáltatási főszereplők jogkivonatainak kezelése című részt.

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.

databricks konfigurálása

Konfiguráljon egy profilt a ~/.databrickscfg fájlban. 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. Ha több profilt ad hozzá a .databrickscfg fájlhoz, gyorsan futtathat parancsokat különböző munkaterületeken úgy, hogy megadja a célkapcsolati profil nevét a parancs beállításában --profile . 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 meglévő konfigurációs profilokkal kapcsolatos információkért használja a auth parancscsoportot.

A környezeti változó .databrickscfgbeállításával módosíthatja a DATABRICKS_CONFIG_FILE fájl alapértelmezett elérési útját.

Ha ezt a parancsot nem interaktív módban hívja meg, akkor az stdinből olvassa be a jogkivonatot. A gazdagépet a --host jelölővel vagy a DATABRICKS_HOST környezeti változóval kell megadni.

databricks configure [flags]

Beállítások

--configure-cluster

    A fürt konfigurálására vonatkozó utasítások

--host string

    Databricks-munkaterület gazdagépének URL-címe

A munkaterület-gazdagép URL-címe a munkaterületenkénti URL-cím, amelynek formátuma 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.

--profile string

    A konfigurálni kívánt kapcsolatprofil neve. (alapértelmezett "ALAPÉRTELMEZETT")

Globális jelzők

Examples

Az alábbi példa az alapértelmezett profil hitelesítését konfigurálja:

databricks configure

Az alábbi példa egy adott profil hitelesítését konfigurálja:

databricks configure --profile my-profile

Az alábbi példa egy adott kiszolgálóval konfigurálja a hitelesítést.

databricks configure --host https://my-workspace.cloud.databricks.com

Az alábbi példa fürtkonfigurációval konfigurálja a hitelesítést:

databricks configure --configure-cluster

Globális jelzők

--debug

  Engedélyezze-e a hibakeresési naplózást.

-h vagy --help

    Súgó megjelenítése a Databricks parancssori felületéhez, a kapcsolódó parancscsoporthoz vagy a kapcsolódó parancshoz.

--log-file karakterlánc

    A karakterlánc, amely megadja, melyik fájlba írja az kimeneti naplókat. Ha ez a jelző nincs megadva, akkor az alapértelmezett beállítás a kimeneti naplók stderrbe írása.

--log-format formátum

    A naplóformátum típusa, amely lehet text vagy json. Az alapértelmezett érték a text.

--log-level karakterlánc

    A naplóformátum szintjét képviselő karakterlánc. Ha nincs megadva, a naplóformátum szintje le van tiltva.

-o, --output típus

    A parancs kimenettípusa: text vagy json. Az alapértelmezett érték a text.

-p, --profile karakterlánc

    A parancs futtatásához használni kívánt fájl profiljának ~/.databrickscfg neve. Ha ez a jelző nincs megadva, akkor ha létezik, a rendszer a névvel ellátott DEFAULT profilt használja.

--progress-format formátum

    A folyamatnaplók megjelenítésének formátuma: default, append, inplacevagy json

-t, --target karakterlánc

    Ha alkalmazható, a használni kívánt célcsomag

Konfigurációs profil létrehozása

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

databricks configure --host <workspace-url>

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 DEFAULTtartalmazza:

[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>

Tip

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.