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.

Aktualizovat

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 úložiště Databricks/homebrew-tap 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

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

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

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

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

3. 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

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

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

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 curl strá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 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

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

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

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 má Latest vedle ní popisek 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 Series / 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: Nabídka> ikony Apple o tomto Macu nebo příkaz uname -mTerminá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 pojmenovaný databricks_cli_X.Y.Z_SHA256SUMS ve stejném seznamu jako .zip soubory. 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 z příkazového řádku linuxového prostředí, terminálu macOS nebo příkazového řádku Windows zobrazíte verzi spustitelného souboru Rozhraní příkazového řádku Databricks pomocí -v možnosti nebo spuštěním version příkazu:

   databricks -v
   
   # Or:
   databricks version
   

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

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

   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

U této možnosti 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ého řádku linuxového prostředí nebo terminálu macOS použijte Homebrew ke stažení a aktualizaci na nejnovější verzi spustitelného souboru Rozhraní příkazového řádku Databricks 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

   Pokud se zobrazí očekávané aktualizované číslo verze, 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 má Latest vedle ní popisek v seznamu vydaných verzí.

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

Tip

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 Rozhraní příkazového řádku Databricks 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

   Pokud se zobrazí očekávané aktualizované číslo verze, 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 má Latest vedle ní popisek v seznamu vydaných verzí.

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

Čokoládová aktualizace 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 novější 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 Rozhraní příkazového řádku Databricks 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é. Uděláte to tak -v , že pomocí možnosti nebo spuštěním version příkazu zobrazíte verzi spustitelného souboru rozhraní příkazového řádku Databricks:

   databricks -v
   
   # Or:
   databricks version
   

   Pokud se zobrazí očekávané aktualizované číslo verze, 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 má Latest vedle ní popisek v seznamu vydaných verzí.

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

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

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 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é. Uděláte to tak, že v terminálu zobrazíte verzi spustitelného souboru Rozhraní příkazového řádku Databricks pomocí -v možnosti nebo spuštěním version příkazu:

   databricks -v
   
   # Or:
   databricks version
   

   Pokud se zobrazí očekávané aktualizované číslo verze, 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 má Latest vedle ní popisek v seznamu vydaných verzí.

   Poznámka:

   Pokud spustíte databricks , ale zobrazí se chyba, například command not found: databricksnebo pokud spustíte databricks -v a zobrazí se číslo verze 0.18 nebo nižší, znamená to, že váš počítač nemůže najít správnou verzi spustitelného souboru rozhraní příkazového řádku Databricks. Pokud chcete tento problém vyřešit, přečtěte si téma Ověření instalace rozhraní příkazového řádku.

Zdrojová aktualizace pro Linux, macOS a Windows

Pro tuto možnost aktualizace 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. Volitelně můžete odstranit spustitelný soubor Rozhraní příkazového řádku Databricks, .zip soubor a .zip extrahovaný soubor z jakéhokoli předchozího postupu ruční instalace zdroje.
2. Pokračujte podle pokynů v instalaci zdroje pro Linux, macOS a Windows.