De Databricks CLI installeren of bijwerken

Notitie

Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger, die zich in openbare preview bevinden. Voer de opdracht uit databricks -vom uw versie van de Databricks CLI te vinden.

In dit artikel wordt beschreven hoe u de Databricks CLI installeert of bijwerkt. Zie Wat is de Databricks CLI?

Installeren

Als u Databricks CLI versie 0.205 of hoger wilt installeren:

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

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

Bijwerken

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

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

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, betekent dit dat de Databricks CLI correct is geïnstalleerd.

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

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 een versienummer van 0.205.0 of hoger wordt vermeld, betekent dit dat de Databricks CLI correct is geïnstalleerd.

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

3. 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 een versienummer van 0.205.0 of hoger wordt vermeld, betekent dit dat de Databricks CLI correct is geïnstalleerd.

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

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 zijn unzip 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 zijn geïnstalleerd. 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 dit 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 dit om het uitvoerbare Bestand van 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 alle besturingssystemen):

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

   Notitie

   Als u de inhoud van het script wilt weergeven voordat u het uitvoert, raadpleegt u het install.sh-bestand in de Databricks CLI Setup-opslagplaats in GitHub.

   Voor Windows moet u deze opdracht uitvoeren als beheerder.

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

   Met deze opdracht downloadt en installeert u het uitvoerbare bestand van Databricks CLI in het pad /usr/local/bin/databricks op macOS en Linux en C:\Windows\databricks.exe in 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 een versienummer van 0.205.0 of hoger wordt vermeld, betekent dit dat de Databricks CLI correct is geïnstalleerd.

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

5. Ga verder met verificatie voor de Databricks CLI.

Broninstallatie 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-bits / 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 64-bits / 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-bits / x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel 64-bits / 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 icon menu >About This Mac, or the Terminal command uname -m.
   • Windows: de opdrachtprompt of PowerShell 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 bekijkt u de versie van het uitvoerbare bestand van Databricks CLI via een Linux-shellprompt, macOS Terminal of Windows-opdrachtprompt met behulp van de -v optie of door de version opdracht uit te voeren:

   databricks -v
   
   # Or:
   databricks version
   

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

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

   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 het verwachte bijgewerkte versienummer wordt weergegeven, wordt de Databricks CLI correct geïnstalleerd.

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

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

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 het verwachte bijgewerkte versienummer wordt weergegeven, wordt de Databricks CLI correct geïnstalleerd.

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

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

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 het verwachte bijgewerkte versienummer wordt weergegeven, wordt de Databricks CLI correct geïnstalleerd.

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

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

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 zijn unzip geïnstalleerd. 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 in macOS en Linux, of C:\Windows\databricks.exe in Windows.

2. Gebruik vanaf een Linux-shellprompt, macOS Terminal of Windows-opdrachtprompt curl de meest recente versie van het uitvoerbare Databricks CLI-bestand 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):

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

   Notitie

   Als u de inhoud van het script wilt weergeven voordat u het uitvoert, raadpleegt u het install.sh-bestand in de Databricks CLI Setup-opslagplaats in GitHub.

   Voor Windows moet u deze opdracht uitvoeren als beheerder.

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

   Met deze opdracht downloadt en installeert u het uitvoerbare bestand van Databricks CLI in het pad /usr/local/bin/databricks op macOS en Linux en C:\Windows\databricks.exe in 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 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 het verwachte bijgewerkte versienummer wordt weergegeven, wordt de Databricks CLI correct geïnstalleerd.

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

   Notitie

   Als u maar databricks een fout krijgt, zoals command not found: databricks, of als u uitvoert databricks -v en een versienummer van 0.18 of lager wordt vermeld, betekent dit dat uw computer de juiste versie van het uitvoerbare Bestand van de Databricks CLI niet kan vinden. Zie Uw CLI-installatie controleren om dit probleem op te lossen.

Bronupdate 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 de broninstallatie voor Linux, macOS en Windows.

De Databricks CLI uitvoeren vanuit een Azure Databricks-werkruimte

U hebt toegang tot de Databricks CLI vanuit de webterminal in een notebook dat is verbonden met een actief cluster of rechtstreeks vanuit de webterminal voor een actief cluster. De beschikbare CLI is altijd de nieuwste versie en verificatie is gebaseerd op de huidige gebruiker. Het cluster moet voldoen aan de volgende vereisten:

• Voor het cluster moet Databricks Runtime 15.0 of hoger zijn geïnstalleerd.
• Het cluster moet een clustertoegangsmodus van één gebruiker of geen isolatie gedeeld gebruiken. De toegangsmodus voor gedeelde clusters wordt niet ondersteund.
• Serverloze berekeningen worden niet ondersteund.
• De werkruimte mag niet zijn ingeschakeld voor Private Link.

Ga als volgt te werk om toegang te krijgen tot de CLI vanuit de webterminal voor een notebook:

1. Verbinding maken het notebook naar een cluster dat voldoet aan de voorgaande vereisten.

2. Klik onder aan de rechterzijbalk van het notitieblok op het pictogram van het onderste deelvenster openen.

3. Gebruik de CLI in het terminalvenster dat wordt weergegeven. Met de volgende opdracht wordt bijvoorbeeld informatie over de huidige gebruiker afgedrukt:

   databricks current-user me
   

Ga als volgt te werk om toegang te krijgen tot de CLI vanuit de webterminal voor een cluster:

1. Klik in de zijbalk van de werkruimte op Compute.

2. Klik op het tabblad Alles berekenen op de naam van een cluster dat voldoet aan de voorgaande vereisten.

3. Klik op Start.

4. Nadat het cluster is gestart, klikt u op het tabblad Apps op Web Terminal.

5. Gebruik de CLI in de Databricks-webterminal die wordt weergegeven. Met de volgende opdracht wordt bijvoorbeeld informatie over de huidige gebruiker afgedrukt:

   databricks current-user me