configure skupina příkazů

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

Skupina configure příkazů v rozhraní příkazového řádku Databricks umožňuje ověřovat rozhraní příkazového řádku Databricks pomocí tokenů pat azure Databricks nebo tokenů Microsoft Entra ID (dříve Azure Active Directory).

Poznámka:

Osvědčeným postupem při ověřování pomocí automatizovaných nástrojů, systémů, skriptů a aplikací doporučuje Databricks místo uživatelů pracovního prostoru používat tokeny patního přístupu, které patří instančním objektům . 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 token pat azure Databricks a ověřování tokenu Microsoft Entra ID pro povolení volání příkazů na úrovni pracovního prostoru. Další možnosti konfigurace ověřování najdete v tématu Ověřování rozhraní příkazového řádku Databricks.

Důležité

Před spuštěním tohoto příkazu nezapomeňte nastavit rozhraní příkazového řádku Databricks.

Příkazy spustíte configure tak, že je připojíte k databricks configuresouboru . Pokud chcete zobrazit nápovědu configure k příkazu, spusťte databricks configure -hpříkaz .

Vytvoření konfiguračního profilu

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.

Pokud chcete vytvořit konfigurační profil, spusťte configure příkaz následujícím způsobem:

databricks configure --host <workspace-url>

Zadejte <workspace-url>adresu 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.

Příkaz vás vyzve k zadání tokenu pat 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

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

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.

Přidání více profilů připojení 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 --profile , použije DEFAULT tento příkaz ve výchozím nastavení profil připojení.

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.

Výchozí cestu k tomuto .databrickscfg souboru můžete změnit nastavením proměnné DATABRICKS_CONFIG_FILEprostředí . Informace o nastavení proměnných prostředí najdete v dokumentaci k operačnímu systému.

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