Autorisatie instellen voor de Databricks IDE-extensie

Dit artikel beschrijft hoe je autorisatie en authenticatie kunt instellen tussen de Databricks IDE-extensie en je Azure Databricks workspace als je de extensie nog niet hebt geconfigureerd via de projectopstelling. Zie Databricks IDE-extensie.

De Databricks IDE-extensie implementeert delen van de Databricks unified authentication standaard, waarmee je Azure Databricks OAuth 2.0-gebaseerde autorisatie één keer kunt configureren en die configuratie vervolgens kunt gebruiken over meerdere Azure Databricks-tools en SDK's zonder verdere autorisatie- en authenticatiewijzigingen. Het biedt ook automatische vernieuwingen van actieve toegangstokens, waardoor uw procescomplexiteit tijdens het ontwikkelen wordt verminderd.

Databricks raadt OAuth interactieve gebruikersautorisatie aan, die eenvoudig te configureren is met de Databricks IDE-extensie. Zie OAuth-autorisatie en verificatie instellen.

Als u in plaats daarvan Authenticatie met Azure Databricks persoonlijke toegangstokens (verouderd) gebruikt, Authorize service-principaltoegang tot Azure Databricks met OAuth of Authenticatie met Microsoft Entra service-principals, raadpleeg dan Verificatie instellen met een configuratieprofiel. Voor Authenticatie met de Azure CLI, zie Azure CLI-authenticatie instellen.

Notitie

De Databricks IDE-extensie ondersteunt geen authenticatie met Azure managed identities (voorheen Azure Managed Service Identities (MSI)), maar Databricks Connect zonder de Databricks IDE-extensie wel. Zie Install Databricks Connect for Python om Databricks Connect te installeren.

OAuth-autorisatie en -verificatie instellen

Azure Databricks ondersteunt verificatie en verificatie op basis van OAuth 2.0 en vereenvoudigt het beheer van toegangstokens met Databricks unified authentication. Zie Toegang tot Azure Databricks-resources voor meer informatie over autorisatie van gebruikers- en service-principals met Azure Databricks.

Om de installatie van OAuth-autorisatie te voltooien, open je je VSCode-project met de Databricks IDE-extensie ingeschakeld:

1. In de Configuratieweergave klik je op Verificatietype en klik vervolgens op het tandwielpictogram (aanmelden bij Databricks-werkruimte).

   

2. Als u al een verificatieconfiguratieprofiel in deze lijst hebt met het label Verifiëren met behulp van OAuth (gebruiker naar machine) en dat u weet dat deze overeenkomt met de doel-Databricks-host, selecteert u dit in de lijst en doet u het volgende:

   1. Als u hierom wordt gevraagd, voert u de instructies op het scherm in uw webbrowser uit om de verificatie met Azure Databricks te voltooien.
   2. Als u hierom wordt gevraagd, staat u toegang tot alle API's toe.
   3. Ga verder naar Rekenkracht selecteren voor het uitvoeren van code en taken.

3. Klik in het opdrachtenpalet voor verificatiemethode selecteren op OAuth (gebruiker naar computer).

4. Voor Verificatiemethode selecteren selecteer OAuth (gebruiker naar machine).

5. Voer een naam in voor het bijbehorende Azure Databricks verificatieprofiel.

6. Klik in de configuratieweergave op Aanmelden bij Databricks.

   

7. Selecteer in het opdrachtenpalet bij de verificatiemethode selecteren de naam van het verificatieconfiguratieprofiel dat u zojuist hebt gemaakt.

8. Als u hierom wordt gevraagd, voert u de instructies op het scherm in uw webbrowser uit om de verificatie met Azure Databricks te voltooien. Als u hierom wordt gevraagd, staat u toegang tot alle API's toe.

9. Nadat u bent aangemeld, keert u terug naar Visual Studio Code.

Verificatie instellen met een configuratieprofiel

In de volgende instructies wordt ervan uitgegaan dat u al een Azure Databricks-configuratieprofiel hebt ingesteld met de vereiste velden voor uw Azure Databricks verificatietype. Zie Azure Databricks-configuratieprofielen om een profiel te maken. Als u instellingen voor het profiel wilt configureren, raadpleegt u het tabblad of de sectie Profile voor uw verificatietype in Toegang tot Azure Databricks resources.

Ga als volgt te werk om het configuratieprofiel te selecteren dat u wilt gebruiken voor de extensie, waarbij uw project en de extensie zijn geopend:

1. In de Configuratieweergave klik je op Verificatietype en klik vervolgens op het tandwielpictogram (aanmelden bij Databricks-werkruimte).

   

2. Selecteer in het Command Palette je doel-Azure Databricks-configuratieprofiel in de lijst.

   Aanbeveling

   De host van de doelwerkruimte kan later worden gewijzigd door de doelinstelling workspace te wijzigen in het databricks.yml configuratiebestand dat aan het project is gekoppeld. Zie doelen.

Als u geen configuratieprofiel hebt, kunt u er een maken die wordt geverifieerd met behulp van een Azure Databricks persoonlijk toegangstoken, bijvoorbeeld als volgt:

1. Wanneer uw project en de extensie zijn geopend, klikt u in de configuratieweergave op Verificatietype of Aanmelden bij Databricks en klikt u vervolgens op het tandwielpictogram (Aanmelden bij Databricks-werkruimte).

   

2. Selecteer persoonlijk toegangstoken in het opdrachtenpalet.

3. Voltooi de aanwijzingen op het scherm om het volgende te doen:

   1. Voer een naam in voor het bijbehorende Azure Databricks verificatieprofiel.
   2. Genereer het persoonlijke toegangstoken in uw Azure Databricks werkruimte en kopieer de waarde van het token.
   3. Ga terug naar de extensie en voer de waarde van het gekopieerde token in.

Met de extensie maakt u een map in uw project met de naam .databricks een bestand met de naam databricks.env, als deze nog niet bestaat. Dit bestand bevat de workspace-host die je hebt ingevoerd, samen met andere Azure Databricks-configuratiedetails die door de Databricks IDE-extensie worden gebruikt.

Met de extensie wordt ook een verborgen .gitignore bestand aan het project toegevoegd als het bestand niet bestaat of als er geen bestaande .gitignore in bovenliggende mappen kan worden gevonden. Als er een nieuw .gitignore bestand wordt gemaakt, voegt de extensie een .databricks/ vermelding toe aan dit nieuwe bestand. Als met de extensie een bestaand .gitignore bestand wordt gevonden, wordt er een .databricks/ vermelding toegevoegd aan het bestaande bestand.

Azure CLI-authenticatie instellen

Azure Databricks ondersteunt verificatie met de Azure CLI lokaal geïnstalleerd. Hiermee kunt u kortlevende tokens (één uur) genereren Microsoft Entra ID tokens, waardoor het risico op onbedoelde blootstelling van tokens met een langere levensduur, zoals Azure Databricks persoonlijke toegangstokens, wordt voorkomen via versiebeheercontroles of andere middelen.

Wanneer uw project en de extensie zijn geopend en de Azure CLI lokaal geïnstalleerd, gaat u als volgt te werk:

1. Klik in de configuratieweergave op Databricks configureren.

   Notitie

   Als Configureer Databricks niet zichtbaar is, klikt u op het tandwielpictogram (Configureer werkruimte) naast Configuratie.

   

2. Voer in het opdrachtpalet voor Databricks Host uw URL per werkruimte in, bijvoorbeeld . Druk vervolgens op Enter.

3. Selecteer Azure CLI.