Sdílet prostřednictvím


Kurz k rozhraní příkazového řádku Databricks

Poznámka:

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší, které jsou ve verzi Public Preview. Pokud chcete zjistit svou verzi rozhraní příkazového řádku Databricks, spusťte databricks -vpříkaz .

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

Tento článek ukazuje, jak pomocí místního vývojového počítače rychle začít s rozhraním příkazového řádku Databricks. Podívejte se, co je rozhraní příkazového řádku Databricks?

V následujícím praktickém kurzu se předpokládá:

Proveďte následující kroky:

  1. Pokud ještě není nainstalovaný, nainstalujte rozhraní příkazového řádku Databricks následujícím způsobem:

    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 Rozhraní příkazového řádku Databricks s 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
    

    Použití WSL k instalaci rozhraní 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
    

    Poznámka:

    Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

Po instalaci rozhraní příkazového řádku Databricks proveďte následující kroky:

Poznámka:

V tomto kurzu se předpokládá, že chcete k ověření rozhraní příkazového řádku použít ověřování U2M (user-to-machine) OAuth 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í rozhraní příkazového řádku Databricks zahajte místní správu tokenů OAuth 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 <workspace-url> adresou URL azure Databricks pro jednotlivé pracovní prostory, například https://adb-1234567890123456.7.azuredatabricks.net.

    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.

    Pokud chcete získat seznam všech existujících profilů, v samostatném terminálu nebo příkazovém řádku spusťte příkaz databricks auth profilespomocí rozhraní příkazového řádku Databricks . 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 --host hodnotami a --account-id hodnotami, možná budete muset zadat --hostparametr , --account-ida -p možnosti 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 zadat společně --host možnosti a -p pomoct rozhraní příkazového řádku Databricks najít správné odpovídající informace o tokenu OAuth.

Další kroky

Po nastavení rozhraní příkazového řádku Databricks:

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