Delen via

Zelfstudie over Databricks CLI

  • Artikel

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.

In dit artikel wordt beschreven hoe u uw lokale ontwikkelcomputer gebruikt om snel aan de slag te get gaan met de Databricks CLI. Zie Wat is de Databricks CLI?

In de volgende praktische zelfstudie wordt ervan uitgegaan:

Voltooi de volgende stappen:

  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

    Windows

    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 get een fout zoals command not found: databricks, of als u databricks -v uitvoert 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.

Nadat u de Databricks CLI hebt geïnstalleerd, voert u de volgende stappen uit:

Notitie

In deze zelfstudie wordt ervan uitgegaan dat u OAuth-gebruikers-naar-machine-verificatie (U2M) wilt gebruiken 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 bewerkingen op werkruimteniveau vervangt u in de volgende opdracht <workspace-url> bijvoorbeeld de URLhttps://adb-1234567890123456.7.azuredatabricks.netper werkruimte.

    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 getlist van een bestaand profiel wilt verfijnen, gebruikt u de Databricks CLI in een andere terminal of opdrachtprompt om het commando databricks auth profilesuit te voeren. 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-idvalueshebt, 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 --hostvalueshebt, moet u mogelijk de --host en -p opties opgeven om de Databricks CLI te helpen de juiste overeenkomende OAuth-tokengegevens te vinden.

Volgende stappen

Nadat u de Databricks CLI hebt set: