Zelfstudie over Databricks CLI

  • Artikel

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.

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 gaan met de Databricks CLI. Zie Wat is de Databricks CLI?

In de volgende praktische zelfstudie wordt ervan uitgegaan:

  • Voor Linux of macOS hebt u Homebrew geïnstalleerd.

    Notitie

    Als u Homebrew niet kunt gebruiken, raadpleegt u De Databricks CLI installeren of bijwerken voor andere manieren om de CLI te installeren.

  • Voor Windows hebt u winget, Chocolatey of Windows-subsysteem voor Linux (WSL) geïnstalleerd. Zie de documentatie van uw besturingssysteem voor installatie-instructies.

    Notitie

    Het installeren van de Databricks CLI met Chocolatey is experimenteel.

    Als u de CLI niet kunt gebruiken winget, Chocolatey of WSL, raadpleegt u De Databricks CLI installeren of bijwerken voor andere manieren om de CLI te installeren.

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

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.net van uw Azure Databricks per 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 een lijst met bestaande profielen wilt ophalen, gebruikt u in een afzonderlijke terminal of opdrachtprompt de Databricks CLI om de opdracht 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-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

Nadat u de Databricks CLI hebt ingesteld: