Konfigurációs profilok a Databricks parancssori felületéhez

Megjegyzés

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.

Ez a cikk bemutatja, hogyan használható a Databricks parancssori felület konfigurációs profilokkal. Feltételezi, hogy már telepítette a Databricks parancssori felületet, és létrehozott egy Databricks-konfigurációs profilfájlt. Lásd: Databricks CLI- és Azure Databricks-konfigurációs profilok telepítése vagy frissítése.

A konfigurációs profilokkal kapcsolatos információk lekérése

Ha több konfigurációs profilt ad hozzá a .databrickscfg fájlhoz, gyorsan futtathat parancsokat különböző munkaterületeken úgy, hogy megadja a célkonfigurációs profil nevét a parancs --profile vagy -p a jelzőben. Ha nem ad meg profilt, a parancssori felület az alábbi sorrendben választ egyet:

  1. Ha DATABRICKS_CONFIG_PROFILE be van állítva a környezeti változó.
  2. A(z) .databrickscfg[__settings__] szakaszában található default_profile beállítás, ha van ilyen. Ezt beállíthatja a következővel databricks auth switch: . Lásd a databricks hitelesítési kapcsolót.
  3. A DEFAULT profil.

Tipp

A Tab--profile vagy -p után lenyomva megjelenítheti a választható meglévő konfigurációs profilok listáját.

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

Alapértelmezés szerint a Databricks CLI a .databrickscfg fájlt a ~ mappában (a felhasználó saját könyvtárában) keresi Unix, Linux vagy macOS rendszeren, illetve a %USERPROFILE% mappában (a felhasználó saját könyvtárában) Windows rendszeren. A .databrickscfg fájl alapértelmezett elérési útjának módosításához állítsa a DATABRICKS_CONFIG_FILE környezeti változót egy másik elérési útra. Lásd a .databrickscfg-specifikus mezőket.

Ha egy meglévő konfigurációs profilról szeretne információt kapni, futtassa a auth describe parancsot:

databricks auth describe --profile <configuration-profile-name>

Itt látható például az Azure Databricks személyes hozzáférési jogkivonat-hitelesítéssel konfigurált profil kimenete:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Megjegyzés

A auth env parancs elavult. A databricks auth describe használható egy profil konfigurációjának ellenőrzésére, a databricks auth token pedig egy gyorsítótárazott OAuth hozzáférési token lekérésére.

Az összes elérhető profilról az auth profiles parancs futtatásával kaphat információt:

databricks auth profiles
Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

A parancs kimenete auth profiles nem jelenít meg hozzáférési jogkivonatokat. Egy adott profil tokenadatainak megjelenítéséhez futtassa a databricks auth describe --profile <profile-name> vagy databricks auth token --profile <profile-name> parancsot.

Fontos

A Databricks parancssori felület nem működik .netrc fájllal. Más célokra is használhat fájlokat .netrc a környezetben, de a Databricks parancssori felülete nem fogja használni ezt a .netrc fájlt.

Konfigurációs profilok tesztelése

A konfigurációs profilok teszteléséhez és a hitelesítés helyes beállításának ellenőrzéséhez futtasson egy munkaterülethez csatlakozó parancsot.

Ha nem ad meg profilt, a rendszer az alapértelmezett profilt használja. Az alábbi parancs például felsorolja a DEFAULT-profilhoz társított Azure Databricks-munkaterület elérhető Databricks-futtatókörnyezeti verzióit.

Megjegyzés

Ez a parancs feltételezi, hogy nincsenek olyan környezeti változók, amelyek elsőbbséget élveznek a DEFAULT-profil beállításaival szemben. További információkért lásd a hitelesítés kiértékelési sorrendjét.

databricks clusters spark-versions

Egy adott konfigurációs profil ellenőrzéséhez adja meg a profil nevét a -p jelölő használatával.

databricks clusters spark-versions -p PROD