Instalace nebo aktualizace rozhraní příkazového řádku Databricks

Poznámka:

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve verzi Public Preview.

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Tento článek popisuje, jak nainstalovat nebo aktualizovat rozhraní příkazového řádku Databricks. Vizte Databricks CLI. Pokud chcete nakonfigurovat ověřování pro rozhraní příkazového řádku Databricks, přečtěte si téma Ověřování rozhraní příkazového řádku Databricks.

Instalace

Instalace Databricks CLI verze 0.205 nebo vyšší:

• Linux nebo macOS: Použijte homebrew, curl nebo zdrojové buildy.
• Windows: Použijte WinGet, Chocolatey, Windows Subsystem for Linux (WSL) nebo source builds.

Rozhraní příkazového řádku Databricks je také dostupné v uživatelském rozhraní pracovního prostoru Azure Databricks. Podívejte se na spuštění příkazů rozhraní příkazového řádku Databricks.

Aktualizace

Aktualizace dřívější instalace Rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší:

• Linux nebo macOS: Použijte homebrew, curl nebo zdrojové buildy.
• Windows: Použijte WinGet, Chocolatey, Windows Subsystem for Linux (WSL) nebo source builds.

Instalace Homebrew pro Linux nebo macOS

Pro tuto možnost instalace použijete Homebrew k automatickému stažení a instalaci nejnovější spustitelné verze Rozhraní příkazového řádku Databricks.

V terminálu jednoduše spusťte následující dva příkazy Homebrew a nainstalujte rozhraní příkazového řádku:

brew tap databricks/tap
brew install databricks

Pak pokračujte v ověřování rozhraní příkazového řádku Databricks.

Pokud si nejste jistí, jestli máte nainstalovaný Homebrew, nebo pokud předchozí příkazy Homebrew selžou, postupujte podle těchto delších pokynů:

1. Spuštěním následujícího příkazu z příkazového řádku linuxového prostředí nebo terminálu macOS zkontrolujte, jestli je homebrew již nainstalovaný. Pokud je homebrew nainstalovaný, zobrazí se číslo verze Homebrew:

   brew -v
   

2. Pokud Homebrew ještě není nainstalovaný, nainstalujte ho spuštěním následujícího příkazu:

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

   Potom spuštěním následujícího příkazu ověřte instalaci Homebrew, která zobrazí číslo verze Homebrew:

   brew -v
   

3. Pomocí Homebrew přidejte úložiště databricks/homebrew-tap GitHub do seznamu dostupných úložišť Homebrew Tap spuštěním následujícího příkazu:

   brew tap databricks/tap
   

4. Použijte Homebrew k tomu, abyste dali úložišti pokyn ke stažení a instalaci spustitelného souboru Databricks CLI, tím, že spustíte následující příkaz:

   brew install databricks
   

5. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je uvedeno číslo verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

6. Pokračujte s ověřováním pro Databricks CLI.

Instalace WinGetu pro Windows

Pro tuto možnost instalace použijete winget k automatickému stažení a instalaci nejnovější spustitelné verze Rozhraní příkazového řádku Databricks.

1. Na příkazovém řádku spusťte následující dva winget příkazy pro instalaci rozhraní příkazového řádku a restartujte příkazový řádek:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

1. Pokračujte s ověřováním pro Databricks CLI.

Instalace Chocolatey pro Windows

Poznámka:

Instalace Databricks CLI s Chocolatey je experimentální.

Pro tuto možnost instalace použijete Chocolatey k automatickému stažení a instalaci nejnovější spustitelné verze Rozhraní příkazového řádku Databricks.

1. Z příkazového řádku spusťte následující choco příkaz, který nainstaluje rozhraní příkazového řádku:

   choco install databricks-cli
   

2. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

3. Pokračujte s ověřováním pro Databricks CLI.

instalace curl pro Linux, macOS a Windows

Pro tuto možnost instalace použijete curl ke stažení a instalaci nejnovější spustitelné verze Rozhraní příkazového řádku Databricks.

Pro Windows doporučuje Databricks používat Windows Subsystem for Linux (WSL). Musíte mít unzip také nainstalovanou. Pokyny k instalaci najdete v dokumentaci k vašemu operačnímu systému. Pokud nemůžete použít WSL, přeskočte tento postup a místo toho pomocí příkazového řádku nebo PowerShellu nainstalujte rozhraní příkazového řádku Databricks ze zdroje .

1. curl musí být nainstalován. Spuštěním následujícího příkazu z příkazového řádku linuxového prostředí, terminálu macOS nebo Bash ve WSL můžete zkontrolovat, jestli curl už je nainstalovaný. Pokud je curl nainstalována, zobrazí se číslo verze curl.

   curl -V
   

2. Pokud curl ještě není nainstalovaný, nainstalujte ho podle pokynů na curlstránce Vydané verze a soubory ke stažení pro váš operační systém a architekturu. Pokud chcete získat architekturu vašeho počítače, přečtěte si dokumentaci k vašemu operačnímu systému.

   Potom spuštěním následujícího příkazu ověřte curl instalaci, která zobrazí curl číslo verze:

   curl -V
   

3. Použijte curl ke stažení a instalaci spustitelného souboru Rozhraní příkazového řádku Databricks spuštěním následujícího příkazu (všimněte si, že musíte zadat správná velká a malá písmena pro -fsSL všechny operační systémy):

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

   Poznámka:

   Pokud chcete zobrazit obsah skriptu před spuštěním, podívejte se na soubor install.sh v úložišti nastavení rozhraní příkazového řádku Databricks v GitHub.

   Pro Windows byste měli tento příkaz spustit jako správce.

   Pokud se v případě Linuxu a macOS zobrazí chybová zpráva s informacemi o tom, že /usr/local/bin nelze zapisovat, spusťte příkaz znovu pomocí sudopříkazu .

   Tento příkaz stáhne a nainstaluje spustitelný soubor rozhraní příkazového řádku Databricks do cesty /usr/local/bin/databricks v systémech macOS a Linux a C:\Windows\databricks.exe na Windows.

   Pokud je z nějakého důvodu rozhraní příkazového řádku Databricks již nainstalované, zobrazí se následující chyba: Cílová cesta <path> již existuje. Pokud chcete tento problém vyřešit, musíte ručně odstranit spustitelný soubor rozhraní příkazového řádku Databricks z předchozí cesty a pak příkaz spustit curl znovu.

4. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

5. Pokračujte s ověřováním pro Databricks CLI.

Instalace ze zdrojového kódu pro Linux, macOS a Windows

Pro tuto možnost instalace ručně stáhnete .zip soubor a potom ručně extrahujete spustitelný soubor Rozhraní příkazového řádku Databricks ze staženého .zip souboru.

1. Stáhněte si na místní vývojový počítač nejnovější soubor Rozhraní příkazového řádku Databricks .zip uvedený v části Releases úložiště Rozhraní příkazového řádku Databricks v GitHub. Nejnovější verze obsahuje popisek Latest vedle něj v seznamu vydaných verzí. Nejnovější předběžná verze má Pre-release popisek a je vhodnější pro experimentování a dřívější uživatele. Soubor .zip , který si stáhnete z Assets části vydané verze, musí odpovídat operačnímu systému a architektuře vašeho vývojového počítače:

   Název souboru	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 Řada / arm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux, Intel 64bitový / x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux, ARM 64bitová/ arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows, Intel 32bitová / x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel 64bitová / AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows, ARM 64bitová / ARM64

   Pokud chcete získat architekturu vašeho počítače, přečtěte si dokumentaci k vašemu operačnímu systému. Příklad:

   • Linux: Příkazy uname -mterminálu , lscpunebo sudo lshw -c cpu.
   • macOS: Menu s ikonou Apple>O tomto Macu, nebo příkaz uname -m v Terminálu.
   • Windows: Příkazový řádek nebo příkaz PowerShellu echo %PROCESSOR_ARCHITECTURE%.

   Pokud potřebujete ověřit integritu jednoho z těchto .zip souborů, databricks poskytuje kontrolní součet s názvem databricks_cli_X.Y.Z_SHA256SUMS ve stejném seznamu jako soubory .zip. Pokud chcete spustit ověření kontrolního součtu, přečtěte si dokumentaci k vašemu operačnímu systému.

2. Extrahujte obsah staženého .zip souboru. Pokud chcete soubor extrahovat .zip , přečtěte si dokumentaci k vašemu operačnímu systému.

3. V extrahovaném obsahu se zobrazí složka se stejným názvem jako .zip soubor. Ve složce se nachází spustitelný soubor CLI Databricks. Spustitelný soubor rozhraní příkazového řádku Databricks můžete nechat tam, nebo ho můžete zkopírovat nebo přesunout do jiného umístění.

4. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Uděláte to tak, že z příkazového řádku linuxového prostředí, terminálu macOS nebo Windows příkazového řádku zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version:

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

   Poznámka:

   V případě macOS možná budete muset autorizovat systém, aby mohl nejprve spustit Rozhraní příkazového řádku Databricks. Viz Otevření aplikace pro Mac od neidentifikovaného vývojáře.

5. Pokračujte s ověřováním pro Databricks CLI.

aktualizace Homebrew pro Linux nebo macOS

Pro tuto možnost aktualizace použijete Homebrew k automatické aktualizaci předchozí instalace Rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší na nejnovější verzi.

1. Z příkazové řádky v systému Linux nebo z Terminálu v macOS použijte Homebrew ke stažení a aktualizaci na nejnovější verzi spustitelného souboru Databricks CLI spuštěním následujícího příkazu:

   brew upgrade databricks
   

2. Ověřte, jestli je rozhraní příkazového řádku Databricks správně aktualizované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

   Seznam verzí rozhraní příkazového řádku Databricks najdete v části Releases úložiště Rozhraní příkazového řádku Databricks v GitHub. Nejnovější verze obsahuje popisek Latest vedle něj v seznamu vydaných verzí.

Návod

Pokud chcete downgradovat verzi rozhraní příkazového řádku Databricks, přečtěte si pokyny v úložišti databricks/homebrew-tap v GitHub.

aktualizace WinGet pro Windows

Pro tuto možnost aktualizace použijete winget k automatickému stažení a aktualizaci předchozí verze Rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší na nejnovější verzi.

1. Z příkazového řádku použijte winget ke stažení a aktualizaci na nejnovější verzi spustitelného souboru Databricks CLI spuštěním následujícího příkazu:

   winget upgrade Databricks.DatabricksCLI
   

2. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

   Seznam verzí rozhraní příkazového řádku Databricks najdete v části Releases úložiště Rozhraní příkazového řádku Databricks v GitHub. Nejnovější verze obsahuje popisek Latest vedle něj v seznamu vydaných verzí.

Chocolatey update pro Windows

Poznámka:

Aktualizace rozhraní příkazového řádku Databricks pomocí Chocolatey je experimentální.

Pro tuto možnost aktualizace použijete Chocolatey k automatickému stažení a aktualizaci předchozí verze Rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší na nejnovější verzi.

1. Z příkazového řádku použijte choco ke stažení a aktualizaci na nejnovější verzi spustitelného souboru Databricks CLI spuštěním následujícího příkazu:

   choco upgrade databricks-cli
   

2. Ověřte, jestli je rozhraní příkazového řádku Databricks správně nainstalované. Chcete-li to udělat, zobrazte verzi spustitelného souboru rozhraní příkazového řádku Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

   Seznam verzí rozhraní příkazového řádku Databricks najdete v části Releases úložiště Rozhraní příkazového řádku Databricks v GitHub. Nejnovější verze obsahuje popisek Latest vedle něj v seznamu vydaných verzí.

aktualizace curl pro Linux, macOS a Windows

Pro tuto možnost aktualizace použijete curl k automatickému stažení a aktualizaci předchozí instalace Rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší na nejnovější verzi.

Pro Windows doporučuje Databricks používat Windows Subsystem for Linux (WSL). Musíte mít unzip nainstalovanou. Pokyny k instalaci najdete v dokumentaci k vašemu operačnímu systému. Pokud nemůžete použít WSL, měli byste tento postup přeskočit a použít příkazový řádek nebo PowerShell k aktualizaci rozhraní příkazového řádku Databricks ze zdrojového.

1. Odstraňte existující instalaci spustitelného souboru rozhraní příkazového řádku Databricks ze systémové cesty /usr/local/bin/databricks v systému macOS a Linux nebo C:\Windows\databricks.exe na Windows.

2. Z příkazového řádku linuxového prostředí, terminálu macOS nebo příkazového řádku Windows curl stáhněte a nainstalujte nejnovější verzi spustitelného souboru rozhraní příkazového řádku Databricks spuštěním následujícího příkazu (nezapomeňte, že pro -fsSL musíte zadat správná velká a malá písmena):

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

   Poznámka:

   Pokud chcete zobrazit obsah skriptu před spuštěním, podívejte se na soubor install.sh v úložišti nastavení rozhraní příkazového řádku Databricks v GitHub.

   Pro Windows byste měli tento příkaz spustit jako správce.

   Pokud se v případě Linuxu a macOS zobrazí chybová zpráva s informacemi o tom, že /usr/local/bin nelze zapisovat, spusťte příkaz znovu pomocí sudopříkazu .

   Tento příkaz stáhne a nainstaluje spustitelný soubor rozhraní příkazového řádku Databricks do cesty /usr/local/bin/databricks v systémech macOS a Linux a C:\Windows\databricks.exe na Windows.

   Pokud se zobrazí následující chyba, musíte ručně odstranit spustitelný soubor rozhraní příkazového řádku Databricks z předchozí cesty a pak příkaz spustit curl znovu: Cílová cesta <path> již existuje.

3. Ověřte, jestli je rozhraní příkazového řádku Databricks správně aktualizované. Provedete to tak, že ve svém terminálu zobrazíte verzi spustitelného souboru CLI Databricks pomocí možnosti -v nebo spuštěním příkazu version.

   databricks -v
   
   # Or:
   databricks version
   

   Pokud je výstup verze 0.205.0 nebo vyšší, je rozhraní příkazového řádku Databricks správně nainstalované.

   Seznam verzí rozhraní příkazového řádku Databricks najdete v části Releases úložiště Rozhraní příkazového řádku Databricks v GitHub. Nejnovější verze obsahuje popisek Latest vedle něj v seznamu vydaných verzí.

Aktualizace zdroje pro Linux, macOS a Windows

U této možnosti aktualizace ručně stáhnete soubor .zip a ručně extrahujete spustitelný soubor Rozhraní příkazového řádku Databricks ze staženého souboru .zip.

1. Volitelně můžete odstranit spustitelný soubor Rozhraní příkazového řádku Databricks, soubor .zip a složku souboru .zip po extrakci z jakéhokoli předchozího ručního postupu instalace ze zdroje.
2. Pokračujte podle pokynů v instalaci Source pro Linux, macOS a Windows.