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

Poznámka:

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve verzi Public Preview.

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í více konfiguračních profilů do souboru .databrickscfg umožňuje 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 do --profile příkazu nebo příznaku -p. Pokud není zadaný, použije se konfigurační profil DEFAULT.

Tip

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.

Rozhraní příkazového řádku Databricks ve výchozím nastavení hledá .databrickscfg soubor ve složce (domovská ~ stránka uživatele) v systémech Unix, Linux nebo macOS nebo ve vaší %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. Podívejte se na proměnné prostředí a pole specifická pro .databrickscfg a.

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

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

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

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

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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. Pokud chcete zobrazit přístupový token, spusťte předchozí auth env příkaz.

Důležité

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

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