Konfigurera auktorisering för Databricks-tillägget för Visual Studio Code

Den här artikeln beskriver hur du konfigurerar auktorisering och autentisering mellan Databricks-tillägget för Visual Studio Code och din Azure Databricks arbetsyta om du inte redan har konfigurerat tillägget via projektkonfigurationen. Se Databricks-tillägget för Visual Studio Code.

Databricks-tillägget för Visual Studio Code implementerar delar av Databricks enhetlig autentisering standard, som gör att du kan konfigurera Azure Databricks OAuth 2.0-baserad auktorisering en gång och sedan använda den konfigurationen över flera Azure Databricks verktyg och SDK:er utan ytterligare auktoriserings- och autentiseringskonfigurationsändringar. Det ger också automatiska uppdateringar av aktiva åtkomsttoken, vilket minskar processkomplexiteten när du utvecklar.

Databricks rekommenderar OAuth interaktiv användarauktorisering, vilket är enkelt att konfigurera med hjälp av Databricks-tillägget för Visual Studio Code. 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-tillägget för Visual Studio Code stöder inte autentisering med hjälp av Azure hanterade identiteter (tidigare Azure hanterade tjänstidentiteter (MSI)), men Databricks Connect som används utan Databricks-tillägget för Visual Studio Code 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.

Om du vill slutföra installationen för OAuth-auktorisering öppnar du VSCode-projektet med Databricks-tillägget för Visual Studio Code 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. Den här filen innehåller den arbetsytevärd som du angav, tillsammans med andra Azure Databricks konfigurationsinformation som används av Databricks-tillägget för Visual Studio Code.

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.