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. Podívejte se, co je rozhraní příkazového řádku Databricks? 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 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, Subsystém Windows pro Linux (WSL) nebo zdrojové buildy.

Rozhraní příkazového řádku Databricks je k dispozici také v uživatelském rozhraní pracovního prostoru Azure Databricks. Viz Příkazy 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, Subsystém Windows pro Linux (WSL) nebo zdrojové buildy.

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 databricks/homebrew-tap úložiště v GitHubu do seznamu dostupných úložišť Homebrew Tap spuštěním následujícího příkazu:

   brew tap databricks/tap
   

4. Pomocí Homebrew můžete dát úložišti pokyn databricks/homebrew-tap ke stažení a instalaci spustitelného souboru Rozhraní příkazového řádku Databricks spuštěním následujícího příkazu:

   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 v ověřování rozhraní příkazového řádku Databricks.

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 v ověřování rozhraní příkazového řádku Databricks.

Čokoládová instalace pro Windows

Poznámka:

Instalace Rozhraní příkazového řádku Databricks 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 v ověřování rozhraní příkazového řádku Databricks.

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 databricks doporučuje používat Subsystém Windows pro 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 curl je nainstalována, curl zobrazí se číslo verze:

   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 jeho spuštěním, podívejte se na soubor install.sh v úložišti nastavení rozhraní příkazového řádku Databricks na GitHubu.

   Pro Windows byste tento příkaz měli 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 v cestě /usr/local/bin/databricks v systémech macOS a Linux a C:\Windows\databricks.exe ve 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 v ověřování rozhraní příkazového řádku Databricks.

Zdrojová instalace 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 .zip Databricks, jak je uvedeno v části Vydané verze úložiště Rozhraní příkazového řádku Databricks na GitHubu. 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 64bitová/ 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: nebo příkaz >Terminálu .
   • Windows: Příkazový řádek nebo příkaz echo %PROCESSOR_ARCHITECTURE%PowerShellu .

   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. Uvnitř této složky je spustitelný soubor Rozhraní příkazového řádku 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 v příkazovém řádku linuxového prostředí, terminálu macOS nebo příkazovém řádku Windows 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é.

   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 v ověřování rozhraní příkazového řádku Databricks.

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 Vydané verze úložiště Rozhraní příkazového řádku Databricks na GitHubu. 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 na GitHubu.

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 Vydané verze úložiště Rozhraní příkazového řádku Databricks na GitHubu. 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 Vydané verze úložiště Rozhraní příkazového řádku Databricks na GitHubu. 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 databricks doporučuje používat Subsystém Windows pro 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 z cesty /usr/local/bin/databricks v systému macOS a Linux nebo C:\Windows\databricks.exe ve Windows.

2. Z příkazového řádku linuxového prostředí, terminálu macOS nebo příkazového řádku systému Windows použijte curl ke stažení a instalaci nejnovější verze 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):

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

   Poznámka:

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

   Pro Windows byste tento příkaz měli 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 v cestě /usr/local/bin/databricks v systémech macOS a Linux a C:\Windows\databricks.exe ve 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 Vydané verze úložiště Rozhraní příkazového řádku Databricks na GitHubu. 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 zdroje pro Linux, macOS a Windows.