Udostępnij przez

Poradnik CLI Databricks

Uwaga

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs wiersza polecenia Databricks jest dostępny w publicznej wersji zapoznawczej.

Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.

Interfejs wiersza polecenia Databricks (znany również jako Databricks CLI) to narzędzie, które udostępnia łatwy w użyciu interfejs do automatyzowania platformy Azure Databricks z poziomu terminalu, wiersza polecenia lub skryptów automatyzacji. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?.

W tym artykule pokazano, jak szybko zainstalować i skonfigurować interfejs wiersza polecenia usługi Databricks.

Potwierdzanie wymagań dotyczących komputera lokalnego

W tym samouczku założono że:

Zainstaluj Databricks CLI

  1. Zainstaluj interfejs wiersza polecenia usługi Databricks:

    Linux, macOS

    Użyj Homebrew, aby zainstalować interfejs wiersza polecenia Databricks, uruchamiając następujące dwa polecenia:

    brew tap databricks/tap
brew install databricks

    Windows

    Do zainstalowania interfejsu wiersza polecenia usługi Databricks można użyć zestawu narzędzi winget, Chocolatey lub Podsystem Windows dla systemu Linux (WSL). Jeśli nie możesz użyć winget, Chocolatey lub WSL, należy pominąć tę procedurę i użyć wiersza polecenia lub programu PowerShell, aby zainstalować Databricks CLI ze źródła.

    Uwaga

    Instalowanie za pomocą platformy Chocolatey interfejsu wiersza polecenia usługi Databricks jest eksperymentalne.

    Aby użyć winget do zainstalowania interfejsu wiersza polecenia usługi Databricks, uruchom następujące dwa polecenia, a następnie uruchom ponownie Wiersz Polecenia.

    winget search databricks
winget install Databricks.DatabricksCLI

    Aby zainstalować Databricks CLI za pomocą narzędzia Chocolatey, uruchom następujące polecenie.

    choco install databricks-cli

    Aby użyć programu WSL do zainstalowania interfejsu wiersza polecenia usługi Databricks:

    1. Zainstaluj curl i zip przez WSL. Aby uzyskać więcej informacji, zobacz dokumentację systemu operacyjnego.

    2. Użyj programu WSL, aby zainstalować interfejs wiersza polecenia usługi Databricks, uruchamiając następujące polecenie:

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

  2. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest zainstalowany, uruchamiając następujące polecenie, które wyświetla bieżącą wersję zainstalowanego interfejsu wiersza polecenia usługi Databricks. Ta wersja powinna mieć wartość 0.205.0 lub nowszą:

    databricks -v

Konfigurowanie dostępu do obszaru roboczego

Następnie skonfiguruj dostęp do obszaru roboczego usługi Databricks.

Uwaga

W tym samouczku użyto uwierzytelniania użytkownika-komputera (U2M) OAuth do uwierzytelniania interfejsu wiersza polecenia przy użyciu konta użytkownika usługi Azure Databricks. Aby skonfigurować interfejs wiersza polecenia do używania innych typów uwierzytelniania usługi Databricks, zobacz Uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

  1. Użyj Databricks CLI, aby lokalnie zainicjować zarządzanie tokenami OAuth, uruchamiając następujące polecenie dla każdego konta docelowego lub obszaru roboczego.

    W przypadku operacji na poziomie konta w następującym poleceniu, zastąp następujące placeholdery:

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

    W przypadku operacji na poziomie obszaru roboczego w poniższym poleceniu zastąp <workspace-url> ciąg adresem URL na obszar roboczy usługi Azure Databricks, na przykład .

    databricks auth login --host <workspace-url>

  2. Interfejs wiersza polecenia Databricks zapyta, czy chcesz zapisać wprowadzone informacje jako profil konfiguracji Azure Databricks. Naciśnij Enter , aby zaakceptować sugerowaną nazwę profilu lub wprowadź nazwę nowego lub istniejącego profilu. Każdy istniejący profil o tej samej nazwie zostanie zastąpiony wprowadzonymi informacjami. Profile umożliwiają szybkie przełączanie kontekstu uwierzytelniania między wieloma kontami lub obszarami roboczymi.

    Aby uzyskać listę wszystkich istniejących profilów, w osobnym terminalu lub wierszu polecenia użyj interfejsu wiersza polecenia usługi Databricks, aby uruchomić polecenie databricks auth profiles. Aby wyświetlić istniejące ustawienia określonego profilu, uruchom polecenie databricks auth env --profile <profile-name>.

  3. W przeglądarce internetowej wykonaj instrukcje na ekranie, aby zalogować się do konta lub obszaru roboczego usługi Azure Databricks.

  4. Aby wyświetlić bieżącą wartość tokenu OAuth profilu i zbliżający się znacznik czasu wygaśnięcia tokenu, uruchom jedno z następujących poleceń:

    W przypadku operacji na poziomie konta uruchom następujące polecenia:

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

    Jeśli masz wiele profilów z tymi samymi wartościami --host i --account-id, może być konieczne określenie opcji --host, --account-idi -p, aby ułatwić interfejsowi wiersza poleceń Databricks znalezienie prawidłowych pasujących informacji o tokenie OAuth.

    W przypadku operacji na poziomie obszaru roboczego uruchom następujące polecenia:

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

    Jeśli masz wiele profilów z tymi samymi wartościami --host, może być konieczne, aby określić opcje --host i -p, aby ułatwić interfejsowi wiersza polecenia Databricks znalezienie odpowiednich informacji o tokenie OAuth.

Następne kroki

  • Last updated on