Ställ in auktorisation för Databricks IDE-tillägg

Den här artikeln beskriver hur du ställer in auktorisation och autentisering mellan Databricks IDE-tillägget och din Azure Databricks-arbetsyta om du inte redan har konfigurerat tillägget via projektuppsättningen. Se Databricks IDE-tillägg.

Databricks IDE-tillägg implementerar delar av Databricks unified authentication standard, vilket gör det möjligt att konfigurera Azure Databricks OAuth 2.0-baserad auktorisation en gång och sedan använda den konfigurationen över flera Azure Databricks-verktyg och SDK:er utan ytterligare auktorisations- och autentiseringsändringar. Det ger också automatiska uppdateringar av aktiva åtkomsttoken, vilket minskar processkomplexiteten när du utvecklar.

Databricks rekommenderar OAuths interaktiva användarauktorisation, som är enkel att konfigurera med Databricks IDE-tillägg. Se Konfigurera OAuth-auktorisering och autentisering.

Om du använder autentisering med personliga åtkomsttoken från Azure Databricks (äldre), auktorisera tjänstens huvudnamn åtkomst till Azure Databricks med OAuth eller autentisering med Microsoft Entra tjänstens huvudnamn, se Ställ in autentisering med en konfigurationsprofil. För autentisering med Azure CLI, se konfigurera Azure CLI-autentisering.

Anteckning

Databricks IDE-tillägget stöder inte autentisering med Azure managed identities (tidigare Azure Managed Service Identities (MSI)), men Databricks Connect som används utan Databricks IDE-tillägg gör det. Information om hur du installerar Databricks Connect finns i Installera Databricks Connect för Python.

Konfigurera OAuth-auktorisering och autentisering

Azure Databricks stöder OAuth 2.0-baserad auktorisering och autentisering och förenklar åtkomsttokenhantering med Databricks enhetlig autentisering. Mer information om auktorisering av användar- och tjänsthuvudnamn med Azure Databricks finns i Auktorisera åtkomst till Azure Databricks resurser.

För att slutföra installationen av OAuth-auktorisation, öppna ditt VSCode-projekt med Databricks IDE-tillägg aktiverat:

  1. I vyn Konfiguration klickar du på Autentiseringstyp och sedan på kugghjulsikonen (Logga in på Databricks-arbetsytan).

    Logga in på Databricks-arbetsytan

  2. Om du redan har en autentiseringskonfigurationsprofil i den här listan som har etiketten Autentisera med OAuth (användare till maskin) och som du vet motsvarar värddatorn för Databricks, välj den i listan och gör sedan följande:

    1. Om du uppmanas att göra det slutför du autentiseringen med Azure Databricks genom att följa anvisningarna på skärmen i webbläsaren.
    2. Om du också uppmanas att göra det, tillåt då åtkomst till all-apis.
    3. Gå vidare till Välj beräkning för att köra kod och jobb.
  3. I kommandopaletten för Välj autentiseringsmetod klickar du på OAuth (användare till dator).

  4. För Välj autentiseringsmetod väljer du OAuth (användare till dator).

  5. Ange ett namn för den associerade Azure Databricks-autentiseringsprofilen.

  6. I konfigurationsvyn klickar du på Logga in på Databricks.

    Logga in på Databricks

  7. I kommandopaletten för Välj autentiseringsmetod väljer du namnet på den autentiseringskonfigurationsprofil som du nyss skapade.

  8. Om du uppmanas att göra det slutför du autentiseringen med Azure Databricks genom att följa anvisningarna på skärmen i webbläsaren. Om du också uppmanas att göra det, tillåt då åtkomst till all-apis.

  9. När du har loggat in återgår du till Visual Studio Code.

Konfigurera autentisering med en konfigurationsprofil

Följande instruktioner förutsätter att du redan har konfigurerat en Azure Databricks konfigurationsprofil med de obligatoriska fälten för din Azure Databricks autentiseringstyp. Information om hur du skapar en profil finns i Azure Databricks konfigurationsprofiler. Information om hur du konfigurerar inställningar för profilen finns på fliken Profile eller avsnittet för din autentiseringstyp i Auktorisera åtkomst till Azure Databricks resurser.

Gör följande för att välja den konfigurationsprofil som du vill att tillägget ska använda med projektet och tillägget öppet:

  1. I vyn Konfiguration klickar du på Autentiseringstyp och sedan på kugghjulsikonen (Logga in på Databricks-arbetsytan).

    Logga in på Databricks-arbetsytan

  2. I Command Palette väljer du din Azure Databricks konfigurationsprofil i listan.

    Tips

    Målarbetsytans värd kan ändras senare genom att ändra målinställningen workspacedatabricks.yml i konfigurationsfilen som är associerad med projektet. Se mål.

Om du inte har någon konfigurationsprofil kan du skapa en som autentiserar med hjälp av en Azure Databricks personlig åtkomsttoken, till exempel på följande sätt:

  1. När projektet och tillägget är öppna klickar du på Autentiseringstyp eller Logga in på Databricks i konfigurationsvyn och klickar sedan på kugghjulsikonen (Logga in på Databricks-arbetsytan).

    Logga in på Databricks-arbetsytan

  2. I kommandopaletten väljer du Personlig åtkomsttoken.

  3. Slutför anvisningarna på skärmen för att göra följande:

    1. Ange ett namn för den associerade Azure Databricks-autentiseringsprofilen.
    2. Generera den personliga åtkomsttoken i din Azure Databricks arbetsyta och kopiera sedan tokenvärdet.
    3. Gå tillbaka till tillägget och ange värdet för den kopierade token.

Tillägget skapar en mapp i projektet med namnet .databricks med en fil med namnet databricks.env, om den inte redan finns. Denna fil innehåller den workspace-värd du angav, tillsammans med andra Azure Databricks-konfigurationsdetaljer som används av Databricks IDE-tillägget.

Tillägget lägger också till en dold .gitignore fil i projektet om filen inte finns eller om det inte går att hitta en befintlig .gitignore fil i överordnade mappar. Om en ny .gitignore fil skapas lägger tillägget till en .databricks/ post i den nya filen. Om tillägget hittar en befintlig .gitignore fil, så läggs en .databricks/ post till i den befintliga filen.

Konfigurera Azure CLI-autentiseringen

Azure Databricks stöder autentisering med Azure CLI installerat lokalt. På så sätt kan du generera kortlivade (en timme) Microsoft Entra ID token, vilket eliminerar risken för att oavsiktligt exponera token med längre livslängd, till exempel Azure Databricks personliga åtkomsttoken via kontrollkontroller för versionskontroll eller på annat sätt.

När projektet och tillägget har öppnats och Azure CLI installerat lokalt gör du följande:

  1. I konfigurationsvyn klickar du på Konfigurera Databricks.

    Anteckning

    Om Konfigurera Databricks inte visas klickar du på kugghjulsikonen (Konfigurera arbetsyta) bredvid Konfiguration i stället.

    Kugghjulsikon för att konfigurera arbetsyteinställningar 1

  2. I kommandopaletten för Databricks Host anger du url:en per arbetsyta, till exempel https://adb-1234567890123456.7.azuredatabricks.net. Tryck sedan på Enter.

  3. Välj Azure CLI.