Konfigurační profily pro rozhraní příkazového řádku Databricks

Poznámka:

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Tento článek popisuje, jak používat Rozhraní příkazového řádku Databricks s konfiguračními profily. Předpokládá se, že jste už nainstalovali Rozhraní příkazového řádku Databricks a vytvořili soubor konfiguračních profilů Databricks. Viz Instalujte nebo aktualizujte rozhraní příkazového řádku Databricks a konfigurační profily Azure Databricks .

Získání informací o konfiguračních profilech

Přidáním více konfiguračních profilů do .databrickscfg souboru můžete rychle spouštět příkazy v různých pracovních prostorech zadáním názvu cílového konfiguračního profilu v příkazu --profile nebo -p příznaku. Pokud nezadáte profil, rozhraní příkazového řádku ho vybere v následujícím pořadí:

  1. Proměnná DATABRICKS_CONFIG_PROFILE prostředí, pokud je nastavená.
  2. Nastavení default_profile v [__settings__] části .databrickscfg, pokud je k dispozici. Můžete to nastavit pomocí databricks auth switch. Viz databricks auth switch.
  3. Profil DEFAULT.

Návod

Po Tab nebo --profile můžete stisknout -p a zobrazit seznam existujících dostupných konfiguračních profilů, ze kterých si můžete vybrat.

Můžete mít například konfigurační profil, DEV který odkazuje na pracovní prostor Azure Databricks, který používáte pro vývojové úlohy, a samostatný konfigurační profil s názvem PROD , který odkazuje na jiný pracovní prostor Azure Databricks, který používáte pro produkční úlohy.

Ve výchozím nastavení nástroj Databricks CLI hledá soubor .databrickscfg ve složce ~ (domovské složce uživatele) v systémech Unix, Linux nebo macOS nebo ve složce %USERPROFILE% (domovské složce uživatele) ve Windows. Pokud chcete změnit výchozí cestu k souboru .databrickscfg, nastavte proměnnou prostředí DATABRICKS_CONFIG_FILE na jinou cestu. Viz pole specifická pro .databrickscfg.

Pokud chcete získat informace o existujícím konfiguračním profilu, spusťte příkaz auth describe:

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

Tady je například výstup profilu, který je nakonfigurovaný s ověřováním osobního přístupového tokenu Azure Databricks:

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

Poznámka:

Příkaz auth env je zastaralý. Slouží databricks auth describe ke kontrole konfigurace profilu nebo databricks auth token k načtení přístupového tokenu OAuth uloženého v mezipaměti.

Pokud chcete získat informace o všech dostupných profilech, spusťte příkaz auth profiles:

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

Výstup auth profiles příkazu nezobrazuje žádné přístupové tokeny. Chcete-li zobrazit podrobnosti o tokenu pro určitý profil, spusťte databricks auth describe --profile <profile-name> nebo databricks auth token --profile <profile-name>.

Důležité

Rozhraní příkazového řádku Databricks nefunguje se souborem .netrc. Ve svém prostředí můžete mít soubor .netrc pro jiné účely, ale Databricks CLI tento soubor .netrc nepoužije.

Testování konfiguračních profilů

Pokud chcete otestovat konfigurační profily a ověřit, že jste správně nastavili ověřování, spusťte příkaz, který se připojí k pracovnímu prostoru.

Pokud nezadáte profil, použije se výchozí profil. Následující příkaz například uvádí dostupné verze Databricks Runtime pro pracovní prostor Azure Databricks, který je přidružený k vašemu profilu DEFAULT.

Poznámka:

Tento příkaz předpokládá, že nemáte žádné proměnné prostředí, které mají přednost před nastavením v profilu DEFAULT. Další informace najdete v tématu Pořadí ověřování vyhodnocení.

databricks clusters spark-versions

Pokud chcete ověřit konkrétní konfigurační profil, zadejte název profilu pomocí příznaku -p.

databricks clusters spark-versions -p PROD
  • Last updated on