Delen via

Zelfstudie over Databricks CLI

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.

Het databricks-opdrachtregelinterface (ook wel bekend als de Databricks CLI) biedt een gebruiksvriendelijke interface voor het automatiseren van het Azure Databricks-platform vanuit uw terminal, opdrachtprompt of automatiseringsscripts. Zie Wat is de Databricks CLI?

In dit artikel wordt uitgelegd hoe u de Databricks CLI snel installeert en configureert.

Vereisten voor lokale machines bevestigen

In deze zelfstudie wordt ervan uitgegaan dat:

De Databricks CLI installeren

Installeer eerst de Databricks CLI:

  1. Als deze nog niet is geïnstalleerd, installeert u de Databricks CLI als volgt:

    Linux, macOS

    Gebruik Homebrew om de Databricks CLI te installeren door de volgende twee opdrachten uit te voeren:

    brew tap databricks/tap
brew install databricks

    Ramen

    U kunt winget, Chocolatey of Windows-subsysteem voor Linux (WSL) gebruiken om de Databricks CLI te installeren. Als u deze procedure niet kunt gebruiken winget, Chocolatey of WSL, moet u deze procedure overslaan en in plaats daarvan de Opdrachtprompt of PowerShell gebruiken om de Databricks CLI te installeren vanuit de bron .

    Notitie

    Het installeren van de Databricks CLI met Chocolatey is experimenteel.

    winget Als u de Databricks CLI wilt installeren, voert u de volgende twee opdrachten uit en start u de opdrachtprompt opnieuw:

    winget search databricks
winget install Databricks.DatabricksCLI

    Voer de volgende opdracht uit om Chocolatey te gebruiken om de Databricks CLI te installeren:

    choco install databricks-cli

    WSL gebruiken om de Databricks CLI te installeren:

    1. Installeer curl en zip via WSL. Zie de documentatie van uw besturingssysteem voor meer informatie.

    2. Gebruik WSL om de Databricks CLI te installeren door de volgende opdracht uit te voeren:

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

  2. Controleer of de Databricks CLI is geïnstalleerd door de volgende opdracht uit te voeren, waarin de huidige versie van de geïnstalleerde Databricks CLI wordt weergegeven. Deze versie moet 0.205.0 of hoger zijn:

    databricks -v

    Notitie

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

Toegang tot uw werkruimte configureren

Configureer vervolgens de toegang tot uw Databricks-werkruimte.

Notitie

In deze zelfstudie wordt gebruikgemaakt van OAuth-gebruikers-naar-machine-verificatie (U2M) om de CLI te verifiëren met behulp van uw Azure Databricks-gebruikersaccount. Zie Verificatie voor de Databricks CLI om de CLI te configureren voor het gebruik van andere Databricks-verificatietypen.

  1. Gebruik de Databricks CLI om OAuth-tokenbeheer lokaal te starten door de volgende opdracht uit te voeren voor elk doelaccount of elke werkruimte.

    Voor bewerkingen op accountniveau vervangt u in de volgende opdracht de volgende tijdelijke aanduidingen:

    databricks auth login --host <account-console-url> --account-id <account-id>

    Voor operaties op werkruimteniveau in het volgende commando vervangt u door uw Azure Databricks URL per werkruimte, bijvoorbeeld <workspace-url>.

    databricks auth login --host <workspace-url>

  2. De Databricks CLI vraagt u om de gegevens op te slaan die u hebt ingevoerd als een Azure Databricks-configuratieprofiel. Druk Enter om de voorgestelde profielnaam te accepteren of voer de naam van een nieuw of bestaand profiel in. Elk bestaand profiel met dezelfde naam wordt overschreven met de gegevens die u hebt ingevoerd. U kunt profielen gebruiken om snel uw verificatiecontext over te schakelen tussen meerdere accounts of werkruimten.

    Als u een lijst met bestaande profielen wilt ophalen, gebruikt u de Databricks CLI in een afzonderlijke terminal of opdrachtprompt om de opdracht uit te voeren databricks auth profiles. Als u de bestaande instellingen van een specifiek profiel wilt weergeven, voert u de opdracht databricks auth env --profile <profile-name>uit.

  3. Voltooi in uw webbrowser de instructies op het scherm om u aan te melden bij uw Azure Databricks-account of -werkruimte.

  4. Voer een van de volgende opdrachten uit om de huidige OAuth-tokenwaarde van een profiel en de geplande verlooptijdstempel van het token weer te geven:

    Voer voor bewerkingen op accountniveau de volgende opdrachten uit:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Als u meerdere profielen met dezelfde --host en --account-id waarden hebt, moet u mogelijk de --host, --account-iden -p opties opgeven om de Databricks CLI te helpen de juiste overeenkomende OAuth-tokengegevens te vinden.

    Voer voor bewerkingen op werkruimteniveau de volgende opdrachten uit:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Als u meerdere profielen met dezelfde --host waarden hebt, moet u mogelijk de --host en -p opties opgeven om de Databricks CLI te helpen de juiste overeenkomende OAuth-tokengegevens te vinden.

Volgende stappen