Instalowanie lub aktualizowanie interfejsu wiersza polecenia usługi Databricks

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.

W tym artykule opisano sposób instalowania lub aktualizowania interfejsu wiersza polecenia usługi Databricks. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?. Aby skonfigurować uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks, zobacz Uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Instalowanie

Aby zainstalować interfejs wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej:

• Linux lub macOS: użyj kompilacji homebrew, curl lub źródłowych.
• Windows: użyj winGet, Chocolatey, Podsystem Windows dla systemu Linux (WSL) lub kompilacji źródłowych.

Interfejs wiersza polecenia usługi Databricks jest również dostępny z poziomu interfejsu użytkownika obszaru roboczego usługi Azure Databricks. Zobacz Uruchamianie poleceń interfejsu wiersza polecenia usługi Databricks.

Zaktualizuj

Aby zaktualizować wcześniejszą instalację interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej:

• Linux lub macOS: użyj kompilacji homebrew, curl lub źródłowych.
• Windows: użyj winGet, Chocolatey, Podsystem Windows dla systemu Linux (WSL) lub kompilacji źródłowych.

Instalacja oprogramowania Homebrew dla systemu Linux lub macOS

W przypadku tej opcji instalacji używasz oprogramowania Homebrew do automatycznego pobierania i instalowania najnowszej wersji pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks.

W terminalu uruchom następujące dwa polecenia oprogramowania Homebrew, aby zainstalować interfejs wiersza polecenia:

brew tap databricks/tap
brew install databricks

Następnie przejdź do sekcji Authentication for the Databricks CLI (Uwierzytelnianie interfejsu wiersza polecenia usługi Databricks).

Jeśli nie masz pewności, czy masz zainstalowane oprogramowanie Homebrew, czy poprzednie polecenia oprogramowania Homebrew kończą się niepowodzeniem, wykonaj następujące dłuższe instrukcje:

1. Sprawdź, czy oprogramowanie Homebrew jest już zainstalowane, uruchamiając następujące polecenie z poziomu wiersza polecenia powłoki systemu Linux lub terminalu systemu macOS. Jeśli oprogramowanie Homebrew jest zainstalowane, zostanie wyświetlony numer wersji oprogramowania Homebrew:

   brew -v
   

2. Jeśli oprogramowanie Homebrew nie jest jeszcze zainstalowane, zainstaluj je, uruchamiając następujące polecenie:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   Następnie uruchom następujące polecenie, aby zweryfikować instalację oprogramowania Homebrew, która wyświetla numer wersji oprogramowania Homebrew:

   brew -v
   

3. Użyj oprogramowania Homebrew, aby dodać repozytorium databricks/homebrew-tap w usłudze GitHub do listy dostępnych repozytoriów Homebrew Tap, uruchamiając następujące polecenie:

   brew tap databricks/tap
   

4. Użyj oprogramowania Homebrew, aby poinstruować databricks/homebrew-tap repozytorium, aby pobrać i zainstalować plik wykonywalny interfejsu wiersza polecenia usługi Databricks, uruchamiając następujące polecenie:

   brew install databricks
   

5. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli zostanie wyświetlony numer wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

6. Kontynuuj uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Instalacja WinGet dla systemu Windows

W przypadku tej opcji instalacji używasz zestawu winget do automatycznego pobierania i instalowania najnowszej wersji pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks.

1. W wierszu polecenia uruchom następujące dwa winget polecenia, aby zainstalować interfejs wiersza polecenia, a następnie uruchom ponownie wiersz polecenia:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

1. Kontynuuj uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Instalacja czekolady dla systemu Windows

Uwaga

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

W przypadku tej opcji instalacji użyjesz narzędzia Chocolatey , aby automatycznie pobrać i zainstalować najnowszą wersję wykonywalną interfejsu wiersza polecenia usługi Databricks.

1. W wierszu polecenia uruchom następujące choco polecenie, aby zainstalować interfejs wiersza polecenia:

   choco install databricks-cli
   

2. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

3. Kontynuuj uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Instalacja programu curl dla systemów Linux, macOS i Windows

W przypadku tej opcji instalacji użyj narzędzia curl do pobrania i zainstalowania najnowszej wersji pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks.

W przypadku systemu Windows usługa Databricks zaleca używanie Podsystem Windows dla systemu Linux (WSL). Musisz również mieć unzip zainstalowany program . Aby uzyskać instrukcje dotyczące instalacji, zobacz dokumentację systemu operacyjnego. Jeśli nie możesz użyć programu WSL, pomiń tę procedurę i użyj wiersza polecenia lub programu PowerShell, aby zainstalować interfejs wiersza polecenia usługi Databricks ze źródła .

1. curl musi być zainstalowany. Możesz sprawdzić, czy curl jest już zainstalowany, uruchamiając następujące polecenie z poziomu wiersza polecenia powłoki systemu Linux, terminalu systemu macOS lub powłoki Bash w programie WSL. Jeśli curl jest zainstalowany, curl zostanie wyświetlony numer wersji:

   curl -V
   

2. Jeśli curl nie jest jeszcze zainstalowany, zainstaluj go, postępując zgodnie z instrukcjami na curlstronie Wydania i pliki do pobrania dla systemu operacyjnego i architektury. Aby uzyskać architekturę maszyny, zapoznaj się z dokumentacją systemu operacyjnego.

   Następnie uruchom następujące polecenie, aby zweryfikować instalację curl , która wyświetla curl numer wersji:

   curl -V
   

3. Użyj curl polecenia , aby pobrać i zainstalować plik wykonywalny interfejsu wiersza polecenia usługi Databricks, uruchamiając następujące polecenie (należy pamiętać, że należy określić poprawne wielkie i małe litery dla -fsSL wszystkich systemów operacyjnych):

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

   Uwaga

   Aby wyświetlić zawartość skryptu przed jego uruchomieniem, zobacz plik install.sh w repozytorium Instalatora interfejsu wiersza polecenia usługi Databricks w usłudze GitHub.

   W systemie Windows należy uruchomić to polecenie jako administrator.

   W przypadku systemów Linux i macOS, jeśli komunikat o błędzie wskazuje, że /usr/local/bin nie można zapisywać, uruchom polecenie ponownie za pomocą sudopolecenia .

   To polecenie pobiera i instaluje plik wykonywalny interfejsu wiersza polecenia usługi Databricks w ścieżce w systemach /usr/local/bin/databricks macOS i Linux oraz C:\Windows\databricks.exe w systemie Windows.

   Jeśli z jakiegoś powodu interfejs wiersza polecenia usługi Databricks jest już zainstalowany, zostanie wyświetlony następujący błąd: "Ścieżka <path> docelowa już istnieje". Aby rozwiązać ten problem, należy ręcznie usunąć plik wykonywalny interfejsu wiersza polecenia usługi Databricks z poprzedniej ścieżki, a następnie ponownie uruchomić curl polecenie.

4. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

5. Kontynuuj uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Instalacja źródłowa dla systemów Linux, macOS i Windows

W przypadku tej opcji instalacji ręcznie pobierz .zip plik, a następnie ręcznie wyodrębnij plik wykonywalny interfejsu wiersza polecenia usługi Databricks z pobranego .zip pliku.

1. Pobierz na lokalną maszynę deweloperską najnowszy plik interfejsu wiersza polecenia usługi Databricks, jak pokazano w .zip repozytorium interfejsu wiersza polecenia usługi Databricks w usłudze GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji. Najnowsza wersja wstępna ma etykietę Pre-release i jest bardziej odpowiednia dla eksperymentów i wczesnych użytkowników. Plik .zip, który pobierasz z sekcji Assets wersji, musi być zgodny z systemem operacyjnym i architekturą twojej maszyny deweloperskiej.

   Nazwa pliku	Architektura
   databricks_cli_X.Y.Z_darwin_amd64.zip	macOS, Intel 64-bitowy / x86_64
   databricks_cli_X.Y.Z_darwin_arm64.zip	macOS, Apple Silicon / M Seria / arm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux, Intel 64-bitowy / x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux, ARM 64-bitowy / arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows, Intel 32-bitowy / x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel 64-bitowy / AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows, ARM 64-bitowy / ARM64

   Aby uzyskać architekturę maszyny, zapoznaj się z dokumentacją systemu operacyjnego. Na przykład:

   • Linux: polecenia terminalu uname -m, lscpulub sudo lshw -c cpu.
   • macOS: menu > — informacje o tym komputerze Mac lub polecenie uname -mterminalu .
   • Windows: wiersz polecenia lub polecenie echo %PROCESSOR_ARCHITECTURE%programu PowerShell .

   Jeśli musisz zweryfikować integralność jednego z tych .zip plików, usługa Databricks udostępnia plik sumy kontrolnej o nazwie databricks_cli_X.Y.Z_SHA256SUMS na tej samej liście co .zip pliki. Aby uruchomić weryfikację sumy kontrolnej, zapoznaj się z dokumentacją systemu operacyjnego.

2. Wyodrębnij zawartość pobranego .zip pliku. Aby wyodrębnić .zip plik, zobacz dokumentację systemu operacyjnego.

3. W wyodrębnionej zawartości zostanie wyświetlony folder o takiej samej nazwie jak .zip plik. Wewnątrz tego folderu znajduje się plik wykonywalny interfejsu wiersza polecenia usługi Databricks. Możesz tam pozostawić plik wykonywalny interfejsu wiersza polecenia usługi Databricks lub skopiować lub przenieść go do innej lokalizacji.

4. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, w wierszu poleceń powłoki systemu Linux, terminalu systemu macOS lub wierszu polecenia systemu Windows, wyświetl wersję programu Databricks CLI, używając opcji -v lub uruchamiając polecenie version.

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

   Uwaga

   W przypadku systemu macOS może być konieczne autoryzowanie systemu w celu uprzedniego uruchomienia interfejsu wiersza polecenia usługi Databricks. Zobacz Otwieranie aplikacji dla komputerów Mac od niezidentyfikowanego dewelopera.

5. Kontynuuj uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Aktualizacja oprogramowania Homebrew dla systemu Linux lub macOS

W przypadku tej opcji aktualizacji użyjesz oprogramowania Homebrew , aby automatycznie zaktualizować poprzednią instalację interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej do najnowszej wersji.

1. W wierszu polecenia powłoki systemu Linux lub terminalu systemu macOS użyj oprogramowania Homebrew, aby pobrać i zaktualizować plik wykonywalny interfejsu wiersza polecenia usługi Databricks, uruchamiając następujące polecenie:

   brew upgrade databricks
   

2. Sprawdź, czy interfejs wiersza polecenia usługi Databricks został poprawnie zaktualizowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

   Aby uzyskać listę wersji interfejsu wiersza polecenia usługi Databricks, zobacz sekcję Wydania repozytorium interfejsu wiersza polecenia usługi Databricks w usłudze GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Napiwek

Aby obniżyć wersję interfejsu wiersza polecenia usługi Databricks, zobacz instrukcje w repozytorium databricks/homebrew-tap w usłudze GitHub.

Aktualizacja WinGet dla systemu Windows

W przypadku tej opcji aktualizacji używasz zestawu do automatycznego pobierania i aktualizowania poprzedniej wersji interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej do najnowszej wersji.

1. W wierszu polecenia użyj polecenia winget , aby pobrać i zaktualizować plik wykonywalny interfejsu wiersza polecenia usługi Databricks do najnowszej wersji, uruchamiając następujące polecenie:

   winget upgrade Databricks.DatabricksCLI
   

2. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

   Aby uzyskać listę wersji interfejsu wiersza polecenia usługi Databricks, zobacz sekcję Wydania repozytorium interfejsu wiersza polecenia usługi Databricks w usłudze GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Aktualizacja czekolady dla systemu Windows

Uwaga

Aktualizowanie interfejsu wiersza polecenia usługi Databricks za pomocą narzędzia Chocolatey jest eksperymentalne.

W przypadku tej opcji aktualizacji użyjesz narzędzia Chocolatey , aby automatycznie pobrać i zaktualizować poprzednią wersję interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej do najnowszej wersji.

1. W wierszu polecenia użyj polecenia choco , aby pobrać i zaktualizować plik wykonywalny interfejsu wiersza polecenia usługi Databricks do najnowszej wersji, uruchamiając następujące polecenie:

   choco upgrade databricks-cli
   

2. Upewnij się, że interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany. Aby to zrobić, wyświetl wersję pliku wykonywalnego interfejsu wiersza polecenia Databricks za pomocą opcji -v lub uruchomienia polecenia version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

   Aby uzyskać listę wersji interfejsu wiersza polecenia usługi Databricks, zobacz sekcję Wydania repozytorium interfejsu wiersza polecenia usługi Databricks w usłudze GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Aktualizacja programu curl dla systemów Linux, macOS i Windows

W przypadku tej opcji aktualizacji użyj narzędzia curl , aby automatycznie pobrać i zaktualizować poprzednią instalację interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej do najnowszej wersji.

W przypadku systemu Windows usługa Databricks zaleca używanie Podsystem Windows dla systemu Linux (WSL). Musisz mieć unzip zainstalowany program . Aby uzyskać instrukcje dotyczące instalacji, zobacz dokumentację systemu operacyjnego. Jeśli nie możesz użyć protokołu WSL, należy pominąć tę procedurę i użyć wiersza polecenia lub programu PowerShell, aby zaktualizować interfejs wiersza polecenia usługi Databricks ze źródła .

1. Usuń istniejącą instalację pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks ze ścieżki w systemach /usr/local/bin/databricks macOS i Linux lub C:\Windows\databricks.exe w systemie Windows.

2. W wierszu polecenia powłoki systemu Linux, terminalu systemu macOS lub wierszu polecenia systemu Windows użyj curl polecenia , aby pobrać i zainstalować najnowszą wersję pliku wykonywalnego interfejsu wiersza polecenia usługi Databricks, uruchamiając następujące polecenie (należy pamiętać, że należy określić poprawne wielkie i małe litery dla -fsSLpolecenia ):

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

   Uwaga

   Aby wyświetlić zawartość skryptu przed jego uruchomieniem, zobacz plik install.sh w repozytorium Instalatora interfejsu wiersza polecenia usługi Databricks w usłudze GitHub.

   W systemie Windows należy uruchomić to polecenie jako administrator.

   W przypadku systemów Linux i macOS, jeśli komunikat o błędzie wskazuje, że /usr/local/bin nie można zapisywać, uruchom polecenie ponownie za pomocą sudopolecenia .

   To polecenie pobiera i instaluje plik wykonywalny interfejsu wiersza polecenia usługi Databricks w ścieżce w systemach /usr/local/bin/databricks macOS i Linux oraz C:\Windows\databricks.exe w systemie Windows.

   Jeśli zostanie wyświetlony następujący błąd, musisz ręcznie usunąć plik wykonywalny interfejsu wiersza polecenia usługi Databricks z poprzedniej ścieżki, a następnie ponownie uruchomić curl polecenie: "Ścieżka <path> docelowa już istnieje".

3. Sprawdź, czy interfejs wiersza polecenia usługi Databricks został poprawnie zaktualizowany. W tym celu, w terminalu, wyświetl wersję pliku wykonywalnego Databricks CLI przy użyciu opcji -v lub uruchamiając polecenie version:

   databricks -v
   
   # Or:
   databricks version
   

   Jeśli dane wyjściowe są w wersji 0.205.0 lub nowszej, interfejs wiersza polecenia usługi Databricks jest poprawnie zainstalowany.

   Aby uzyskać listę wersji interfejsu wiersza polecenia usługi Databricks, zobacz sekcję Wydania repozytorium interfejsu wiersza polecenia usługi Databricks w usłudze GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Aktualizacja źródłowa dla systemów Linux, macOS i Windows

W przypadku tej opcji aktualizacji ręcznie pobierz .zip plik, a następnie ręcznie wyodrębnisz plik wykonywalny interfejsu wiersza polecenia usługi Databricks z pobranego .zip pliku.

1. Opcjonalnie usuń plik wykonywalny Databricks CLI, plik .zip oraz wyodrębniony folder pliku .zip z poprzedniej ręcznej procedury instalacji źródłowej.
2. Kontynuuj, postępując zgodnie z instrukcjami w temacie Instalacja źródłowa dla systemów Linux, macOS i Windows.