Sdílet prostřednictvím

Návod 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 veřejné předběžné verzi.

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

Rozhraní příkazového řádku Databricks (označované také jako nástroj Databricks CLI) poskytuje snadno použitelné rozhraní pro automatizaci platformy Azure Databricks z terminálu, příkazového řádku nebo automatizačních skriptů. Podívejte se na Co je rozhraní příkazového řádku Databricks?

Tento článek ukazuje, jak rychle nainstalovat a nakonfigurovat Rozhraní příkazového řádku Databricks.

Potvrzení požadavků na místní počítač

V tomto kurzu se předpokládá, že:

Nainstalujte rozhraní příkazového řádku Databricks

Nejprve nainstalujte rozhraní příkazového řádku Databricks:

  1. Pokud ještě není nainstalovaný, nainstalujte rozhraní příkazového řádku Databricks:

    Linux, macOS

    Pomocí Homebrew nainstalujte Rozhraní příkazového řádku Databricks spuštěním následujících dvou příkazů:

    brew tap databricks/tap
brew install databricks

    Windows

    K instalaci rozhraní příkazového řádku Databricks můžete použít winget, Chocolatey nebo Subsystém Windows pro Linux (WSL). Pokud nemůžete použít winget, Chocolatey nebo WSL, měli byste tento postup přeskočit a místo toho použít příkazový řádek nebo PowerShell k instalaci rozhraní příkazového řádku Databricks ze zdroje .

    Poznámka:

    Instalace Databricks CLI pomocí Chocolatey je experimentální.

    Pokud chcete použít winget k instalaci rozhraní příkazového řádku Databricks, spusťte následující dva příkazy a restartujte příkazový řádek:

    winget search databricks
winget install Databricks.DatabricksCLI

    Pokud chcete k instalaci rozhraní příkazového řádku Databricks použít Chocolatey, spusťte následující příkaz:

    choco install databricks-cli

    Jak použít WSL k instalaci příkazového řádku Databricks:

    1. Nainstalujte curl a zip prostřednictvím WSL. Další informace najdete v dokumentaci k operačnímu systému.

    2. Pomocí WSL nainstalujte rozhraní příkazového řádku Databricks spuštěním následujícího příkazu:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

  2. Spuštěním následujícího příkazu ověřte, že je nainstalované rozhraní příkazového řádku Databricks, které zobrazuje aktuální verzi nainstalovaného rozhraní příkazového řádku Databricks. Tato verze by měla být 0.205.0 nebo vyšší:

    databricks -v

Konfigurace přístupu k pracovnímu prostoru

Dále nakonfigurujte přístup k pracovnímu prostoru Databricks.

Poznámka:

Tento kurz používá ověřování U2M (user-to-machine) OAuth k ověření rozhraní příkazového řádku pomocí uživatelského účtu Azure Databricks. Pokud chcete rozhraní příkazového řádku nakonfigurovat tak, aby používalo jiné typy ověřování Databricks, přečtěte si téma Ověřování rozhraní příkazového řádku Databricks.

  1. Pomocí Databricks CLI zahajte správu tokenů OAuth místně spuštěním následujícího příkazu pro každý cílový účet nebo pracovní prostor.

    V případě operací na úrovni účtu nahraďte v následujícím příkazu následující zástupné symboly:

    databricks auth login --host <account-console-url> --account-id <account-id>

    V případě operací na úrovni pracovního prostoru v následujícím příkazu nahraďte vaší Azure Databricks URL pro jednotlivé pracovní prostory, například <workspace-url>.

    databricks auth login --host <workspace-url>

  2. Rozhraní příkazového řádku Databricks vás vyzve k uložení informací, které jste zadali jako konfigurační profil Azure Databricks. Stisknutím klávesy Enter potvrďte navrhovaný název profilu nebo zadejte název nového nebo existujícího profilu. Všechny existující profily se stejným názvem se přepíšou informacemi, které jste zadali. Pomocí profilů můžete rychle přepínat kontext ověřování mezi více účty nebo pracovními prostory.

    Seznam existujících profilů získáte tak, že v samostatném terminálu nebo příkazovém řádku použijete rozhraní příkazového řádku Databricks ke spuštění příkazu databricks auth profiles. Pokud chcete zobrazit existující nastavení konkrétního profilu, spusťte příkaz databricks auth env --profile <profile-name>.

  3. Ve webovém prohlížeči dokončete pokyny na obrazovce, abyste se přihlásili k účtu nebo pracovnímu prostoru Azure Databricks.

  4. Pokud chcete zobrazit aktuální hodnotu tokenu OAuth profilu a nadcházející časové razítko vypršení platnosti tokenu, spusťte jeden z následujících příkazů:

    V případě operací na úrovni účtu spusťte následující příkazy:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Pokud máte více profilů se stejnými hodnotami --host a --account-id, možná bude nutné zadat parametry --host, --account-id a -p společně, aby rozhraní příkazového řádku Databricks pomohlo najít správné odpovídající informace o tokenu OAuth.

    V případě operací na úrovni pracovního prostoru spusťte následující příkazy:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Pokud máte více profilů se stejnými --host hodnotami, budete možná muset zvážit zadání možností --host a -p společně, abyste pomohli nástroji příkazového řádku Databricks najít správné odpovídající informace o tokenu OAuth.

Další kroky

  • Informace o používání rozhraní příkazového řádku najdete v tématu Základní využití rozhraní příkazového řádku Databricks.
  • Přehled dostupných příkazů rozhraní příkazového řádku najdete v tématu Příkazy rozhraní příkazového řádku Databricks.
  • Pokud se rozhraní příkazového řádku nespustí nebo nevygeneruje neočekávané výsledky, přečtěte si téma Ověření instalace rozhraní příkazového řádku.
  • Last updated on