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

  • Cikk

Megjegyzés:

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak, amelyek nyilvános előzetes verzióban érhetők el. A Databricks parancssori felület verziójának megkereséséhez futtassa a következőt databricks -v: .

Ez a cikk bemutatja, hogyan állíthat be hitelesítést a Databricks parancssori felület és az Azure Databricks-fiókok és -munkaterületek között. Lásd: Mi a Databricks parancssori felület?

Ez a cikk feltételezi, hogy már telepítette a Databricks parancssori felületet, és beállította a parancssori felületet a hitelesítéshez. See:

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 a különböző munkaterületeken úgy, hogy megadja a célkonfigurációs profil nevét a parancsban --profile vagy -p a beállításban azokat a parancsokat, amelyek támogatják ezt a beállítást. Ha nem adja meg a --profile beállítást támogató parancsot vagy -p beállítást, a parancs alapértelmezés szerint a DEFAULT konfigurációs profilt használja.

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.

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 parancssori felület megkeresi a fájlt a .databrickscfg~ Unix, Linux vagy macOS rendszerű unix-, Linux- vagy macOS-mappában, illetve a %USERPROFILE% Windows (saját felhasználói kezdőlapja) mappájában. A környezeti változó DATABRICKS_CONFIG_FILEbeállításával módosíthatja a .databrickscfg fájl alapértelmezett elérési útját. 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.

Egy meglévő konfigurációs profil adatainak lekéréséhez futtassa a auth env következő parancsot:

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

Ha az összes elérhető profilról szeretne információt kapni, futtassa a auth profiles következő parancsot:

databricks auth profiles

Kimenet (a három pont a kihagyott tartalmat jelöli, a rövidség kedvéért):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

A parancs kimenete auth profiles nem jelenít meg hozzáférési jogkivonatokat. A hozzáférési jogkivonat megjelenítéséhez futtassa az előző auth env 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.

Az ALAPÉRTELMEZETT konfigurációs profil beállításának tesztelése

Annak ellenőrzéséhez, hogy helyesen állította-e be a hitelesítést, futtathat-e egy parancsot, például az alábbiakat, amely felsorolja a profilhoz DEFAULT társított Azure Databricks-munkaterületen elérhető Databricks Runtime-verziókat.

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

databricks clusters spark-versions

A konfigurációs profilok tesztelése

Annak ellenőrzéséhez, hogy helyesen állított-e be konfigurációs profilokat, futtathat egy parancsot, például az alábbiakat a munkaterületszintű konfigurációs profilok egyik nevével. Ez a parancs a megadott konfigurációs profilhoz társított Azure Databricks-munkaterület elérhető Databricks-futtatókörnyezeti verzióit sorolja fel, amelyeket a helyőrző <configuration-profile-name>itt jelenít meg:

databricks clusters spark-versions -p <configuration-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.

Egy adott profil részleteinek listázásához futtassa a következő parancsot:

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

Az összes elérhető profil adatainak listázásához futtassa a következő parancsot:

databricks auth profiles