Příkaz configure

Note

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.

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í.

Příkaz configure v rozhraní příkazového řádku Databricks vám umožňuje ověřit přístup k Azure Databricks pomocí osobních přístupových tokenů Azure Databricks nebo tokenů Microsoft Entra ID (dříve Azure Active Directory).

Note

Jako bezpečnostní opatření při ověřování pomocí automatizovaných nástrojů, systémů, skriptů a aplikací doporučuje Databricks používat osobní přístupové tokeny, které patří služebním subjektům, místo uživatelů pracovního prostoru. Pokud chcete vytvořit tokeny pro instanční objekty, přečtěte si téma Správa tokenů instančního objektu.

Tento článek popisuje pouze osobní přístupové tokeny Azure Databricks a ověřování tokenem Microsoft Entra ID pro umožnění volání příkazů na úrovni pracovního prostoru. Další možnosti konfigurace ověřování najdete v části Ověřování pro Databricks CLI.

Nakonfigurujte Databricks

Nakonfigurujte v ~/.databrickscfg souboru profil. Konfigurační profil je kolekce nastavení, která obsahuje ověřovací informace, jako je adresa URL pracovního prostoru Azure Databricks a hodnota přístupového tokenu.

Konfigurační profil má programový název, například DEFAULT, DEVnebo PROD. Přidání více profilů do .databrickscfg souboru umožňuje rychle spouštět příkazy v různých pracovních prostorech zadáním názvu profilu cílového připojení v možnosti příkazu --profile . Pokud v příkazu, který tuto možnost podporuje, nezadáte možnost --profile, příkaz standardně použije profil připojení DEFAULT.

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

Pokud chcete získat informace o existujících konfiguračních profilech, použijte auth skupinu příkazů.

Výchozí cestu k souboru .databrickscfg můžete změnit nastavením proměnné prostředí DATABRICKS_CONFIG_FILE.

Pokud je tento příkaz vyvolán v neinteraktivním režimu, přečte token ze stdin. Hostitel musí být zadán pomocí příznaku --host nebo proměnné prostředí DATABRICKS_HOST.

databricks configure [flags]

Možnosti

--configure-cluster

    Výzvy ke konfiguraci clusteru

--host string

    Adresa URL hostitele pracovního prostoru Databricks

Adresa URL hostitele pracovního prostoru je adresa URL pro jednotlivé pracovní prostory s formátem https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Pokud chcete získat adresu URL pro jednotlivé pracovní prostory, přečtěte si téma Adresa URL pro jednotlivé pracovní prostory.

--profile string

    Název profilu připojení ke konfiguraci. (výchozí "VÝCHOZÍ")

Globální příznaky

Examples

Následující příklad konfiguruje ověřování pro výchozí profil:

databricks configure

Následující příklad konfiguruje ověřování pro konkrétní profil:

databricks configure --profile my-profile

Následující příklad konfiguruje ověřování s konkrétním hostitelem:

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

Následující příklad konfiguruje ověřování s konfigurací clusteru:

databricks configure --configure-cluster

Globální příznaky

--debug

  Zda povolit protokolování ladění.

-h nebo --help

    Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu

--log-file řetězec

    Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.

--log-format formát

    Typ formátu protokolu, text nebo json. Výchozí hodnota je text.

--log-level řetězec

    Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.

-o, --output typ

    Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.

-p, --profile řetězec

    Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.

--progress-format formát

    Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json

-t, --target řetězec

    Pokud je to relevantní, cílový balíček, který se má použít

Vytvoření konfiguračního profilu

Pokud chcete vytvořit konfigurační profil, spusťte configure příkaz:

databricks configure --host <workspace-url>

Příkaz vás vyzve k zadání osobního přístupového tokenu Azure Databricks nebo tokenu Microsoft Entra ID (dříve Azure Active Directory), který se mapuje na zadanou <workspace-url> hodnotu:

✔ Databricks Token:

Po zadání přístupového tokenu se přístupový token uloží do souboru ~/.databrickscfg v Linuxu nebo macOS nebo %USERPROFILE%\.databrickscfg ve Výchozím nastavení ve Windows. Soubor obsahuje výchozí položku profilu připojení s názvem DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Pokud chcete místo profilu DEFAULTpřipojení použít jiný název, přidejte --profile do configure příkazu možnost, například:

databricks configure --host <workspace-url> --profile <profile-name>

Tip

Po Tab nebo --profile můžete stisknout -p a zobrazit seznam existujících dostupných konfiguračních profilů, ze které si můžete vybrat, a nemusíte zadávat název konfiguračního profilu ručně.

Všechny informace o existujícím hostiteli a tokenu v zadaném profilu připojení se přepíšou informacemi o novém hostiteli a tokenu.