Dela via

Självstudie om Databricks CLI

  • Artikel

Kommentar

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Databricks-kommandoradsgränssnittet (även kallat Databricks CLI)-verktyget ger ett lättanvänt gränssnitt för att automatisera Azure Databricks-plattformen från terminalen, kommandotolken eller automationsskripten.

Den här artikeln visar hur du använder din lokala utvecklingsdator för att get började snabbt med Databricks CLI. Se Vad är Databricks CLI?.

Följande praktiska självstudie förutsätter:

Slutför följande steg:

  1. Om den inte redan är installerad installerar du Databricks CLI på följande sätt:

    Linux, macOS

    Använd Homebrew för att installera Databricks CLI genom att köra följande två kommandon:

    brew tap databricks/tap
brew install databricks

    Windows

    Du kan använda winget, Chocolatey eller Windows-undersystem för Linux (WSL) för att installera Databricks CLI. Om du inte kan använda winget, Chocolatey eller WSL bör du hoppa över den här proceduren och använda Kommandotolken eller PowerShell för att installera Databricks CLI från källan i stället.

    Kommentar

    Det är experimentellt att installera Databricks CLI med Chocolatey.

    Om du vill använda winget för att installera Databricks CLI kör du följande två kommandon och startar sedan om kommandotolken:

    winget search databricks
winget install Databricks.DatabricksCLI

    Kör följande kommando för att använda Chocolatey för att installera Databricks CLI:

    choco install databricks-cli

    Så här använder du WSL för att installera Databricks CLI:

    1. Installera curl och zip via WSL. Mer information finns i dokumentationen för ditt operativsystem.

    2. Använd WSL för att installera Databricks CLI genom att köra följande kommando:

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

  2. Bekräfta att Databricks CLI har installerats genom att köra följande kommando, som visar den aktuella versionen av det installerade Databricks CLI. Den här versionen ska vara 0.205.0 eller senare:

    databricks -v

    Kommentar

    Om du kör databricks men get ett fel, till exempel command not found: databricks, eller om du kör databricks -v och ett versionsnummer 0.18 eller senare visas, innebär det att datorn inte kan hitta rätt version av Databricks CLI-körbar fil. Information om hur du åtgärdar detta finns i Verifiera CLI-installationen.

När du har installerat Databricks CLI slutför du följande steg:

Kommentar

Den här självstudien förutsätter att du vill använda U2M-autentisering (OAuth user-to-machine) för att autentisera CLI med ditt Azure Databricks-användarkonto. Information om hur du konfigurerar CLI för att använda andra Typer av Databricks-autentisering finns i Autentisering för Databricks CLI.

  1. Använd Databricks CLI för att initiera OAuth-tokenhantering lokalt genom att köra följande kommando för varje målkonto eller arbetsyta.

    För åtgärder på kontonivå ersätter du följande platshållare i följande kommando:

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

    För åtgärder på arbetsytans nivå ersätter <workspace-url> du i följande kommando med url:en för Azure Databricks per arbetsyta, till exempel https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. Databricks CLI uppmanar dig att spara den information som du angav som en Azure Databricks-konfigurationsprofil. Tryck Enter för att acceptera det föreslagna profilnamnet eller ange namnet på en ny eller befintlig profil. Alla befintliga profiler med samma namn skrivs över med den information som du angav. Du kan använda profiler för att snabbt växla din autentiseringskontext mellan flera konton eller arbetsytor.

    Om du vill get en list av befintliga profiler i en separat terminal eller kommandoprompt använder du Databricks CLI för att köra kommandot databricks auth profiles. Om du vill visa en specifik profils befintliga inställningar kör du kommandot databricks auth env --profile <profile-name>.

  3. I webbläsaren fyller du i anvisningarna på skärmen för att logga in på ditt Azure Databricks-konto eller din arbetsyta.

  4. Om du vill visa en profils aktuella OAuth-tokenvärde och tokens kommande förfallotidsstämpel kör du något av följande kommandon:

    Kör följande kommandon för åtgärder på kontonivå:

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

    Om du har flera profiler med samma --host och --account-idvalueskan du behöva ange alternativen --host, --account-idoch -p tillsammans för att hjälpa Databricks CLI att hitta rätt matchande OAuth-tokeninformation.

    Kör följande kommandon för åtgärder på arbetsytenivå:

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

    Om du har flera profiler med samma --hostvalueskan du behöva ange alternativen --host och -p tillsammans för att hjälpa Databricks CLI att hitta rätt matchande OAuth-tokeninformation.

Nästa steg

När du set upp Databricks CLI: