Udostępnij za pośrednictwem

Samouczek interfejsu wiersza polecenia usługi Databricks

  • Artykuł

Uwaga

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs wiersza polecenia usługi Databricks jest 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 usługi Databricks (znany również jako interfejs wiersza polecenia usługi Databricks) udostępnia łatwy w użyciu interfejs do automatyzowania platformy Azure Databricks z poziomu terminalu, wiersza polecenia lub skryptów automatyzacji.

W tym artykule pokazano, jak szybko rozpocząć pracę z interfejsem wiersza polecenia usługi Databricks przy użyciu lokalnej maszyny dewelopera. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?.

W poniższym samouczku praktycznym przyjęto założenie:

Zakończ poniższe kroki:

  1. Jeśli nie został jeszcze zainstalowany, zainstaluj interfejs wiersza polecenia usługi Databricks w następujący sposób:

    Linux, macOS

    Użyj oprogramowania Homebrew , aby zainstalować interfejs wiersza polecenia usługi 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ć wingetpolecenia , Chocolatey lub WSL, należy pominąć tę procedurę i użyć wiersza polecenia lub programu PowerShell, aby zainstalować interfejs wiersza polecenia usługi Databricks ze źródła .

    Uwaga

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

    winget Aby zainstalować interfejs 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ć interfejs wiersza polecenia usługi Databricks za pomocą aplikacji Chocolatey, uruchom następujące polecenie:

    choco install databricks-cli

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

    1. Instalowanie curl i zip za pośrednictwem programu 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

    Uwaga

    Jeśli uruchomisz databricks polecenie , ale wystąpi błąd, taki jak command not found: databricks, lub jeśli uruchomisz databricks -v polecenie i zostanie wyświetlony numer wersji 0.18 lub poniżej, oznacza to, że maszyna nie może odnaleźć poprawnej wersji pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks. Aby rozwiązać ten problem, zobacz Weryfikowanie instalacji interfejsu wiersza polecenia.

Po zainstalowaniu interfejsu wiersza polecenia usługi Databricks wykonaj następujące kroki:

Uwaga

W tym samouczku założono, że chcesz użyć uwierzytelniania użytkownika do komputera (U2M) OAuth w celu uwierzytelnienia 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 interfejsu wiersza polecenia usługi Databricks, 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 symbole zastępcze:

    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 usługi Azure Databricks na obszar roboczy, na przykład https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. Interfejs wiersza polecenia usługi Databricks monituje o zapisanie informacji wprowadzonych jako profil konfiguracji usługi 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 --host wartościami i --account-id , może być konieczne określenie --hostopcji , --account-idi -p , aby ułatwić interfejsowi wiersza polecenia usługi 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 --host wartościami, może być konieczne określenie --host opcji i -p , aby ułatwić interfejsowi wiersza polecenia usługi Databricks znalezienie prawidłowych pasujących informacji o tokenie OAuth.

Następne kroki

Po skonfigurowaniu interfejsu wiersza polecenia usługi Databricks:

  • Aby dowiedzieć się, jak używać interfejsu wiersza polecenia, zobacz Podstawowe użycie interfejsu wiersza polecenia usługi Databricks.
  • Aby zapoznać się z omówieniem dostępnych poleceń interfejsu wiersza polecenia, zobacz Polecenia interfejsu wiersza polecenia usługi Databricks.
  • Jeśli interfejs wiersza polecenia nie zostanie uruchomiony lub nie generuje nieoczekiwanych wyników, zobacz Weryfikowanie instalacji interfejsu wiersza polecenia.