De Databricks CLI installeren of bijwerken

Notitie

Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger. De Databricks CLI bevindt zich in openbare preview.

Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.

In dit artikel wordt beschreven hoe u de Databricks CLI installeert of bijwerkt. Zie Databricks CLI. Zie Verificatie voor de Databricks CLI om verificatie voor de Databricks CLI te configureren.

Installeren

Als u Databricks CLI versie 0.205 of hoger wilt installeren:

• Linux of macOS: Gebruik Homebrew, curl of source-builds.
• Windows: gebruik WinGet, Chocolatey, Windows-subsysteem voor Linux (WSL) of source builds.

De Databricks CLI is ook beschikbaar vanuit de gebruikersinterface van de Azure Databricks werkruimte. Zie Cli-opdrachten uitvoeren voor Databricks.

bijwerken

Een eerdere installatie van Databricks CLI versie 0.205 of hoger bijwerken:

• Linux of macOS: Homebrew, curl of source builds gebruiken.
• Windows: Gebruik WinGet, Chocolatey, Windows-subsysteem voor Linux (WSL) of source builds.

Homebrew-installatie voor Linux of macOS

Voor deze installatieoptie gebruikt u Homebrew om automatisch de nieuwste uitvoerbare release van Databricks CLI te downloaden en te installeren.

Voer vanuit uw terminal de volgende twee Homebrew-opdrachten uit om de CLI te installeren:

brew tap databricks/tap
brew install databricks

Ga vervolgens verder met verificatie voor de Databricks CLI.

Als u niet zeker weet of Homebrew is geïnstalleerd of als de voorgaande Homebrew-opdrachten mislukken, volgt u deze langere instructies:

1. Controleer of Homebrew al is geïnstalleerd door de volgende opdracht uit te voeren vanaf een Linux-shellprompt of macOS Terminal. Als Homebrew is geïnstalleerd, wordt het versienummer van Homebrew weergegeven:

   brew -v
   

2. Als Homebrew nog niet is geïnstalleerd, installeert u deze door de volgende opdracht uit te voeren:

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

   Voer vervolgens de volgende opdracht uit om de Homebrew-installatie te controleren, waarin het versienummer van Homebrew wordt weergegeven:

   brew -v
   

3. Gebruik Homebrew om de opslagplaats databricks/homebrew-tap in GitHub toe te voegen aan uw lijst met beschikbare Homebrew Tap-opslagplaatsen door de volgende opdracht uit te voeren:

   brew tap databricks/tap
   

4. Gebruik Homebrew om de databricks/homebrew-tap opslagplaats te instrueren om het uitvoerbare bestand van de Databricks CLI te downloaden en te installeren door de volgende opdracht uit te voeren:

   brew install databricks
   

5. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als een versienummer van 0.205.0 of hoger wordt vermeld, wordt de Databricks CLI correct geïnstalleerd.

6. Ga verder met verificatie voor de Databricks CLI.

WinGet-installatie voor Windows

Voor deze installatieoptie gebruikt u winget om automatisch de nieuwste uitvoerbare release van Databricks CLI te downloaden en te installeren.

1. Voer vanaf de opdrachtprompt de volgende twee winget opdrachten uit om de CLI te installeren en start de opdrachtprompt opnieuw op:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

1. Ga verder met verificatie voor de Databricks CLI.

Chocolatey-installatie voor Windows

Notitie

Het installeren van de Databricks CLI met Chocolatey is experimenteel.

Voor deze installatieoptie gebruikt u Chocolatey om automatisch de meest recente uitvoerbare release van Databricks CLI te downloaden en te installeren.

1. Voer vanaf de opdrachtprompt de volgende choco opdracht uit om de CLI te installeren:

   choco install databricks-cli
   

2. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

3. Ga verder met verificatie voor de Databricks CLI.

curl-installatie voor Linux, macOS en Windows

Voor deze installatieoptie gebruikt u curl om de meest recente uitvoerbare release van Databricks CLI te downloaden en te installeren.

Voor Windows raadt Databricks u aan om Windows-subsysteem voor Linux (WSL) te gebruiken. U moet ook unzip hebben geïnstalleerd. Zie de documentatie van uw besturingssysteem voor installatie-instructies. Als u WSL niet kunt gebruiken, slaat u deze procedure over en gebruikt u in plaats daarvan de opdrachtprompt of PowerShell om de Databricks CLI te installeren vanuit de bron .

1. curl moet geïnstalleerd zijn. U kunt controleren of curl deze al is geïnstalleerd door de volgende opdracht uit te voeren vanaf een Linux-shellprompt, macOS Terminal of Bash op WSL. Als curl is geïnstalleerd, wordt het curl versienummer weergegeven.

   curl -V
   

2. Als curl dit nog niet is geïnstalleerd, installeert u deze door de instructies te volgen op de curlpagina Releases en Downloads voor uw besturingssysteem en architectuur. Raadpleeg de documentatie van uw besturingssysteem om de architectuur van uw computer op te halen.

   Voer vervolgens de volgende opdracht uit om de curl installatie te controleren, waarin het curl versienummer wordt weergegeven:

   curl -V
   

3. Gebruik curl om de uitvoerbare Databricks CLI te downloaden en te installeren door de volgende opdracht uit te voeren (houd er rekening mee dat u de juiste hoofdletters en kleine letters moet opgeven voor -fsSL op alle besturingssystemen):

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

   Notitie

   Zie het bestand install.sh in de Databricks CLI Setup-opslagplaats in GitHub om de inhoud van het script weer te geven voordat u het uitvoert.

   Voor Windows moet u deze opdracht uitvoeren als beheerder.

   Als er voor Linux en macOS een foutbericht wordt weergegeven dat /usr/local/bin niet beschrijfbaar is, voer dan de opdracht opnieuw uit met sudo.

   Met deze opdracht downloadt en installeert u het uitvoerbare bestand van de Databricks CLI in het pad /usr/local/bin/databricks op macOS en Linux en C:\Windows\databricks.exe op Windows.

   Als de Databricks CLI om een of andere reden al is geïnstalleerd, wordt de volgende fout weergegeven: 'Doelpad <path> bestaat al'. U kunt dit oplossen door het uitvoerbare bestand van de Databricks CLI handmatig te verwijderen uit het voorgaande pad en vervolgens de curl opdracht opnieuw uit te voeren.

4. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

5. Ga verder met verificatie voor de Databricks CLI.

Source-installatie voor Linux, macOS en Windows

Voor deze installatieoptie downloadt u handmatig een .zip bestand en extraheert u het uitvoerbare bestand van de Databricks CLI handmatig uit het gedownloade .zip bestand.

1. Download naar uw lokale ontwikkelcomputer het meest recente Databricks CLI-bestand .zip, zoals vermeld in de sectie Releases van de Databricks CLI-opslagplaats in GitHub. De nieuwste release heeft een Latest label ernaast in de lijst met releases. De nieuwste pre-release heeft een Pre-release label en is geschikter voor experimenten en early adopters. Het .zip bestand dat u uit de Assets sectie voor de release downloadt, moet overeenkomen met het besturingssysteem en de architectuur van uw ontwikkelcomputer:

   Bestandsnaam	Architectuur
   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 Serie / arm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux, Intel 64-bit / x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux, ARM 64-bits / arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows, Intel 32-bit / x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel 64-bit / AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows, ARM 64-bits / ARM64

   Raadpleeg de documentatie van uw besturingssysteem om de architectuur van uw computer op te halen. Voorbeeld:

   • Linux: De terminalopdrachten uname -m, lscpuof sudo lshw -c cpu.
   • macOS: Apple pictogrammenu >Over deze Mac, of de Terminal-opdracht uname -m.
   • Windows: de opdrachtprompt of PowerShell-opdracht echo %PROCESSOR_ARCHITECTURE%.

   Als u de integriteit van een van deze .zip bestanden wilt controleren, biedt Databricks een controlesombestand met de naam databricks_cli_X.Y.Z_SHA256SUMS in dezelfde lijst als de .zip bestanden. Raadpleeg de documentatie van uw besturingssysteem om een controlesomverificatie uit te voeren.

2. Pak de inhoud van het gedownloade .zip bestand uit. Als u het bestand wilt extraheren, raadpleegt u de .zip documentatie van uw besturingssysteem.

3. In de geëxtraheerde inhoud wordt een map weergegeven met dezelfde naam als het .zip bestand. In deze map bevindt zich het uitvoerbare bestand van Databricks CLI. U kunt het uitvoerbare bestand van de Databricks CLI daar laten staan, of u kunt het kopiëren of verplaatsen naar een andere locatie.

4. Controleer of de Databricks CLI juist is geïnstalleerd. Hiervoor kunt u vanaf een Linux-shellprompt, macOS Terminal of Windows Command Prompt de versie van het uitvoerbare bestand van de Databricks CLI weergeven met behulp van de -v optie of door de version opdracht uit te voeren.

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

   Notitie

   Voor macOS moet u mogelijk uw systeem autoriseren om eerst de Databricks CLI uit te voeren. Zie Een Mac-app openen van een niet-geïdentificeerde ontwikkelaar.

5. Ga verder met verificatie voor de Databricks CLI.

Homebrew-update voor Linux of macOS

Voor deze updateoptie gebruikt u Homebrew om automatisch een eerdere installatie van Databricks CLI versie 0.205 of hoger bij te werken naar de nieuwste versie.

1. Gebruik Homebrew vanuit een Linux-shellprompt of macOS Terminal om de nieuwste versie van het uitvoerbare Databricks CLI-bestand te downloaden en bij te werken door de volgende opdracht uit te voeren:

   brew upgrade databricks
   

2. Controleer of de Databricks CLI correct is bijgewerkt. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

   Zie de sectie Releases van de Databricks CLI-opslagplaats in GitHub voor een lijst met Cli-versies van Databricks. De nieuwste release heeft een Latest label ernaast in de lijst met releases.

Aanbeveling

Als u de versie van de Databricks CLI wilt downgraden, raadpleegt u de instructies in de opslagplaats databricks/homebrew-tap in GitHub.

WinGet-update voor Windows

Voor deze updateoptie gebruikt u winget om automatisch een eerdere versie van Databricks CLI versie 0.205 of hoger te downloaden en bij te werken naar de nieuwste versie.

1. Gebruik vanaf de opdrachtprompt winget om te downloaden en bij te werken naar de nieuwste versie van het uitvoerbare bestand van de Databricks CLI door de volgende opdracht uit te voeren:

   winget upgrade Databricks.DatabricksCLI
   

2. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

   Zie de sectie Releases van de Databricks CLI-opslagplaats in GitHub voor een lijst met Cli-versies van Databricks. De nieuwste release heeft een Latest label ernaast in de lijst met releases.

Chocolatey-update voor Windows

Notitie

Het bijwerken van de Databricks CLI met Chocolatey is experimenteel.

Voor deze updateoptie gebruikt u Chocolatey om automatisch een eerdere versie van Databricks CLI versie 0.205 of hoger te downloaden en bij te werken naar de nieuwste versie.

1. Gebruik vanaf de opdrachtprompt choco om te downloaden en bij te werken naar de nieuwste versie van het uitvoerbare bestand van de Databricks CLI door de volgende opdracht uit te voeren:

   choco upgrade databricks-cli
   

2. Controleer of de Databricks CLI juist is geïnstalleerd. U doet dit door de versie van het uitvoerbare bestand van de Databricks CLI weer te geven met behulp van de -v optie of door de opdracht uit te version voeren:

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

   Zie de sectie Releases van de Databricks CLI-opslagplaats in GitHub voor een lijst met Cli-versies van Databricks. De nieuwste release heeft een Latest label ernaast in de lijst met releases.

curl-update voor Linux, macOS en Windows

Voor deze updateoptie gebruikt u curl om automatisch een eerdere installatie van Databricks CLI versie 0.205 of hoger te downloaden en bij te werken naar de nieuwste versie.

Voor Windows raadt Databricks u aan om Windows-subsysteem voor Linux (WSL) te gebruiken. U moet unzip geïnstalleerd hebben. Zie de documentatie van uw besturingssysteem voor installatie-instructies. Als u WSL niet kunt gebruiken, moet u deze procedure overslaan en in plaats daarvan de opdrachtprompt of PowerShell gebruiken om de Databricks CLI bij te werken vanuit de bron .

1. Verwijder de bestaande installatie van het uitvoerbare bestand van Databricks CLI uit het pad /usr/local/bin/databricks op macOS en Linux, of C:\Windows\databricks.exe op Windows.

2. Gebruik vanaf een Linux-shellprompt, macOS Terminal of Windows Opdrachtprompt curl om de nieuwste versie van de Databricks CLI uitvoerbare bestand te downloaden en te installeren door de volgende opdracht uit te voeren (houd er rekening mee dat u de juiste hoofd- en kleine letters moet opgeven voor -fsSL):

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

   Notitie

   Zie het bestand install.sh in de Databricks CLI Setup-opslagplaats in GitHub om de inhoud van het script weer te geven voordat u het uitvoert.

   Voor Windows moet u deze opdracht uitvoeren als beheerder.

   Als er voor Linux en macOS een foutbericht wordt weergegeven dat /usr/local/bin niet beschrijfbaar is, voer dan de opdracht opnieuw uit met sudo.

   Met deze opdracht downloadt en installeert u het uitvoerbare bestand van de Databricks CLI in het pad /usr/local/bin/databricks op macOS en Linux en C:\Windows\databricks.exe op Windows.

   Als de volgende fout wordt weergegeven, moet u het uitvoerbare bestand van de Databricks CLI handmatig verwijderen uit het voorgaande pad en vervolgens de curl opdracht opnieuw uitvoeren: 'Doelpad <path> bestaat al'.

3. Controleer of de Databricks CLI correct is bijgewerkt. U doet dit door vanuit uw terminal de versie van de uitvoerbare Databricks CLI weer te geven met behulp van de -v optie of door de version opdracht uit te voeren.

   databricks -v
   
   # Or:
   databricks version
   

   Als de uitvoer versie 0.205.0 of hoger is, wordt de Databricks CLI correct geïnstalleerd.

   Zie de sectie Releases van de Databricks CLI-opslagplaats in GitHub voor een lijst met Cli-versies van Databricks. De nieuwste release heeft een Latest label ernaast in de lijst met releases.

Source-update voor Linux, macOS en Windows

Voor deze updateoptie downloadt u handmatig een .zip bestand en extraheert u vervolgens handmatig het uitvoerbare bestand van de Databricks CLI uit het gedownloade .zip bestand.

1. Verwijder eventueel het uitvoerbare bestand van de Databricks CLI, het .zip bestand en de uitgepakte map van het .zip bestand uit een eerdere handmatige installatieprocedure voor de bron.
2. Volg de instructies in Source-installatie voor Linux, macOS en Windows.