Instalowanie lub aktualizowanie CLI 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 testowej.

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 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ć Databricks CLI w wersji 0.205 lub nowszej:

• Linux lub macOS: użyj Homebrew, curl lub kompilacji ze źródła.
• Windows: Użyj WinGet, Chocolatey, Podsystem Windows dla systemu Linux (WSL) lub source builds.

Interfejs wiersza polecenia usługi Databricks jest również dostępny w interfejsie użytkownika obszaru roboczego Azure Databricks. Zobacz Uruchamianie poleceń CLI dla Databricks.

Zaktualizuj

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

• Linux lub macOS: użyj Homebrew, curl lub kompilacji źródłowych.
• Windows: Użyj WinGet, Chocolatey, Podsystem Windows dla systemu Linux (WSL) lub source builds.

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 swoim terminalu uruchom następujące dwa polecenia menedżera pakietów Homebrew, aby zainstalować CLI.

brew tap databricks/tap
brew install databricks

Następnie przejdź do sekcji Uwierzytelnianie dla 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 pakiet Homebrew jest już zainstalowany, poprzez uruchomienie następującego polecenia z wiersza poleceń w powłoce systemu Linux lub w 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 GitHub do listy dostępnych repozytoriów Homebrew Tap, uruchamiając następujące polecenie:

   brew tap databricks/tap
   

4. Użyj Homebrew, aby zainstruować databricks/homebrew-tap repozytorium do pobrania i zainstalowania pliku wykonywalnego Databricks CLI, 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 w Databricks CLI.

instalacja WinGet dla Windows

W przypadku tej opcji instalacji używasz winget do automatycznego pobierania i instalowania najnowszej wersji Databricks CLI.

1. W wierszu polecenia uruchom dwa poniższe winget polecenia, aby zainstalować interfejs wiersza poleceń (CLI), a następnie zrestartuj 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 w Databricks CLI.

instalacja Chocolatey dla Windows

Uwaga

Instalowanie Databricks CLI za pomocą 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ć CLI:

   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 w Databricks CLI.

instalacja 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 Windows usługa Databricks zaleca użycie Podsystem Windows dla systemu Linux (WSL). Musisz również mieć unzip zainstalowany. Aby uzyskać instrukcje dotyczące instalacji, zobacz dokumentację systemu operacyjnego. Jeśli nie możesz użyć WSL, pomiń tę procedurę i użyj wiersza polecenia lub programu PowerShell, aby zainstalować CLI Databricks ze źródła.

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

   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 do pobrania i zainstalowania pliku wykonywalnego Databricks CLI, uruchamiając następujące polecenie (pamiętaj, że trzeba określić poprawne wielkie i małe litery dla -fsSL na wszystkich systemach 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 GitHub.

   W przypadku 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 CLI Databricks na ścieżce /usr/local/bin/databricks w systemach macOS i Linux oraz na 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 CLI usługi Databricks z poprzedniej ścieżki, a następnie ponownie uruchomić polecenie curl.

4. Sprawdź, czy CLI Databricks jest poprawnie zainstalowane. 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 w interfejsie wiersza polecenia usługi Databricks.

instalacja z kodu źródłowego dla systemów Linux, macOS i Windows

W przypadku tej opcji instalacji ręcznie pobierasz plik .zip, a następnie ręcznie wyodrębniasz plik wykonywalny Databricks CLI z pobranego pliku .zip.

1. Pobierz na swoją lokalną maszynę deweloperską najnowszy plik interfejsu wiersza polecenia Databricks .zip, wymieniony w sekcji Releases repozytorium Databricks CLI na GitHubie. 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-bit / 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, 64-bitowe ARM / 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 Apple>Informacje o tym Macu lub polecenie terminala uname -m.
   • Windows: wiersz polecenia lub polecenie programu PowerShell echo %PROCESSOR_ARCHITECTURE%.

   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 Databricks CLI. 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. W tym celu w wierszu polecenia powłoki systemu Linux, terminalu systemu macOS lub wierszu polecenia Windows, wyświetl wersję pliku wykonywalnego 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 w Databricks CLI.

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 Homebrew, aby pobrać i zaktualizować do najnowszej wersji Databricks CLI, 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ę Releases repozytorium interfejsu wiersza polecenia usługi Databricks w GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Wskazówka

Aby obniżyć wersję Databricks CLI, zobacz instrukcje w repozytorium databricks/homebrew-tap w GitHub.

aktualizacja WinGet dla Windows

W przypadku tej opcji aktualizacji używasz winget do automatycznego pobierania i aktualizowania poprzedniej wersji interfejsu wiersza polecenia 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ę Releases repozytorium interfejsu wiersza polecenia usługi Databricks w GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

Aktualizacja Chocolatey dla 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ę Releases repozytorium interfejsu wiersza polecenia usługi Databricks w GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

curl update dla systemów Linux, macOS i Windows

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

W przypadku Windows usługa Databricks zaleca użycie Podsystem Windows dla systemu Linux (WSL). Musisz mieć zainstalowany unzip. 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 CLI usługi Databricks ze ścieżki /usr/local/bin/databricks w systemie macOS i Linux lub C:\Windows\databricks.exe w systemie Windows.

2. W wierszu poleceń powłoki Linux, Terminalu macOS lub Wierszu poleceń Windows, użyj curl do pobrania i zainstalowania najnowszej wersji wykonywalnego pliku Databricks CLI, uruchamiając poniższą komendę (pamiętaj, aby poprawnie określić wielkość liter dla -fsSL):

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

   W przypadku 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 CLI Databricks na ścieżce /usr/local/bin/databricks w systemach macOS i Linux oraz na C:\Windows\databricks.exe w systemie Windows.

   Jeśli pojawi się następujący błąd, musisz ręcznie usunąć plik wykonywalny Databricks CLI z poprzedniej ścieżki, a następnie uruchomić polecenie curl ponownie: "Ścieżka docelowa <path> 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ę Releases repozytorium interfejsu wiersza polecenia usługi Databricks w GitHub. Najnowsza wersja zawiera etykietę Latest obok niej na liście wersji.

aktualizacja źródła dla systemów Linux, macOS i Windows

W przypadku tej opcji aktualizacji 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. 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 Source installation for Linux, macOS i Windows.