Einrichten der Authentifizierung für die Databricks-Erweiterung für Visual Studio Code

In diesem Artikel wird beschrieben, wie Sie die Authentifizierung zwischen der Databricks-Erweiterung für Visual Studio Code und Ihrem Azure Databricks-Arbeitsbereich einrichten. Weitere Informationen finden Sie unter Was ist die Databricks-Erweiterung für Visual Studio Code?.

Die Databricks-Erweiterung für Visual Studio Code implementiert Teile des Standards für die einheitliche Databricks-Clientauthentifizierung, mit dem Sie die Azure Databricks-Authentifizierung einmal konfigurieren und diese Konfiguration dann ohne weitere Änderungen an der Authentifizierungskonfiguration für mehrere Azure Databricks-Tools und SDKs verwenden können.

Databricks empfiehlt die OAuth U2M-Authentifizierung, die mit der Databricks-Erweiterung für Visual Studio Code einfach konfiguriert werden kann. Siehe Einrichten der OAuth U2M-Authentifizierung.

Bei Authentifizierung mit persönlichem Zugriffstoken in Azure Databricks, Authentifizierung des Zugriffs bei Azure Databricks mit einem Dienstprinzipal unter Verwendung von OAuth (OAuth M2M) oder Microsoft Entra ID-Dienstprinzipalauthentifizierung können Sie ansonsten Einrichten der Authentifizierung mit einem Konfigurationsprofil heranziehen. Informationen zur Azure CLI-Authentifizierung finden Sie unter Einrichten der Azure CLI-Authentifizierung.

Hinweis

Die Databricks-Erweiterung für Visual Studio Code unterstützt die Authentifizierung mit verwalteten Azure-Identitäten (ehemals bekannt als Azure Managed Service Identities (MSI)) nicht, Databricks Connect ohne die Databricks-Erweiterung für Visual Studio Code dagegen schon. Informationen zum Installieren von Databricks Connect finden Sie unter Verwenden von Visual Studio Code mit Databricks Connect für Python.

Einrichten der OAuth U2M-Authentifizierung

Azure Databricks unterstützt die OAuth-User-to-Machine-Authentifizierung (U2M). Dadurch können Sie kurzlebige (einstündige) OAuth-Zugriffstoken generieren, wodurch das Risiko entfällt, dass versehentlich langlebigere Token wie persönliche Azure Databricks-Zugriffstoken durch Eincheckvorgänge der Versionskontrolle oder auf andere Weise offengelegt werden. Dies ermöglicht auch eine bessere serverseitige Sitzungsinvalidierung und Bereichsdefinition.

Gehen Sie zum Abschließen des Setup für die OAuth U2M-Authentifizierung bei geöffnetem Projekt und geöffneter Erweiterung folgendermaßen vor:

1. Klicken Sie in der Ansicht Konfiguration auf Authentifizierungstyp und dann auf das Zahnradsymbol (Bei Databricks-Arbeitsbereich anmelden).

   

2. Wenn Sie in dieser Liste bereits ein Konfigurationsprofil mit der Bezeichnung Authentifizierung mit OAuth (U2M) haben und wissen, dass es dem Databricks-Zielhost entspricht, wählen Sie es aus der Liste aus und gehen Sie dann folgendermaßen vor:

   1. Befolgen Sie, wenn Sie dazu aufgefordert werden, die Bildschirmanweisungen in Ihrem Webbrowser, um die Authentifizierung mit Azure Databricks abzuschließen.
   2. Wenn Sie dazu aufgefordert werden, erlauben Sie auch den all-apis-Zugriff.
   3. Fahren Sie fort mit Auswählen eines Clusters zum Ausführen von Code und Aufträgen.

3. Klicken Sie in der Befehlspalette für Authentifizierungsmethode auswählen auf OAuth (U2M).

4. Wählen Sie für Authentifizierungsmethode auswählen die Option OAuth (U2M).

5. Geben Sie einen Namen für das zugeordnete Azure Databricks-Authentifizierungsprofil ein.

6. Klicken Sie in der Ansicht Konfiguration auf Bei Databricks anmelden.

   

7. Wählen Sie in der Befehlspalette für Authentifizierungsmethode auswählen den Namen des soeben erstellten Konfigurationsprofils für die Authentifizierung aus.

8. Befolgen Sie, wenn Sie dazu aufgefordert werden, die Bildschirmanweisungen in Ihrem Webbrowser, um die Authentifizierung mit Azure Databricks abzuschließen. Wenn Sie dazu aufgefordert werden, erlauben Sie auch den all-apis-Zugriff.

9. Kehren Sie, nachdem Sie sich erfolgreich angemeldet haben, zurück zu Visual Studio Code.

Einrichten der Authentifizierung mit einem Konfigurationsprofil

In den folgenden Anweisungen wird davon ausgegangen, dass Sie bereits ein Azure Databricks-Konfigurationsprofil mit den erforderlichen Feldern für Ihren Azure Databricks-Authentifizierungstyp eingerichtet haben. Informationen zum Erstellen eines Profils finden Sie unter Azure Databricks-Konfigurationsprofile. Informationen zum Konfigurieren der Einstellungen für das Profil finden Sie unter der Registerkarte Profile oder im Abschnitt für Ihren Authentifizierungstyp in Authentifizierung des Zugriffs auf Azure Databricks-Ressourcen.

Gehen Sie zum Auswählen des von der Erweiterung zu verwendenden Konfigurationsprofils bei geöffnetem Projekt und geöffneter Erweiterung folgendermaßen vor:

1. Klicken Sie in der Ansicht Konfiguration auf Authentifizierungstyp und dann auf das Zahnradsymbol (Bei Databricks-Arbeitsbereich anmelden).

   

2. Wählen Sie in der Befehlspalette Ihr Azure Databricks-Zielkonfigurationsprofil in der Liste aus.

   Tipp

   Der Zielarbeitsbereichshost kann später durch Ändern der Einstellung workspace für das Ziel in der zum Projekt gehörigen Konfigurationsdatei databricks.yml geändert werden. Weitere Informationen finden Sie unter Konfiguration für Databricks-Ressourcenpakete.

Wenn Sie kein Konfigurationsprofil haben, können Sie wie folgt ein Profil erstellen, das sich z. B. mithilfe eines persönlichen Azure Databricks-Zugriffstokens authentifiziert:

1. Klicken Sie bei geöffnetem Projekt und geöffneter Erweiterung in der Ansicht Konfiguration auf Authentifizierungstyp oder Bei Databricks anmelden und klicken Sie dann auf das Zahnradsymbol (Bei Databricks-Arbeitsbereich anmelden).

   

2. Wählen Sie in der Befehlspalette die Option Persönliches Zugriffstoken aus.

3. Befolgen Sie die angezeigten Eingabeaufforderungen für Folgendes:

   1. Geben Sie einen Namen für das zugeordnete Azure Databricks-Authentifizierungsprofil ein.
   2. Generieren Sie das persönliche Zugriffstoken in Ihrem Azure Databricks-Arbeitsbereich und kopieren Sie dann den Wert des Tokens.
   3. Kehren Sie zur Erweiterung zurück und geben Sie den Wert des kopierten Tokens ein.

Die Erweiterung erstellt in Ihrem Projekt mit dem Namen .databricks einen ausgeblendeten Ordner mit einer Datei mit dem Namen databricks.env, wenn nicht bereits vorhanden. Diese Datei enthält den von Ihnen eingegebenen Arbeitsbereichshost zusammen mit anderen Azure Databricks-Konfigurationsdetails, die von der Databricks-Erweiterung für Visual Studio Code verwendet werden.

Durch die Erweiterung wird dem Projekt auch eine ausgeblendete .gitignore-Datei hinzugefügt, wenn die Datei nicht vorhanden ist oder eine vorhandene .gitignore-Datei in keinem der übergeordneten Ordnern gefunden wird. Wenn eine neue .gitignore-Datei erstellt wird, fügt die Erweiterung dieser neuen Datei einen .databricks/-Eintrag hinzu. Wenn die Erweiterung eine vorhandene .gitignore-Datei findet, fügt sie der vorhandenen Datei einen .databricks/-Eintrag hinzu.

Einrichten der Azure CLI-Authentifizierung

Azure Databricks unterstützt die Authentifizierung mit der lokal installierten Azure CLI. Dadurch können Sie kurzlebige (einstündige) Microsoft Entra ID-Zugriffstoken generieren, wodurch das Risiko entfällt, dass versehentlich langlebigere Token wie persönliche Azure Databricks-Zugriffstoken durch Eincheckvorgänge der Versionskontrolle oder auf andere Weise offengelegt werden.

Während Ihr Projekt und die Erweiterung geöffnet sind und die Azure CLI lokal installiert ist, gehen Sie wie folgt vor:

1. Klicken Sie in der Ansicht Konfiguration auf Databricks konfigurieren.

   Hinweis

   Wenn Databricks konfigurieren nicht angezeigt wird, klicken Sie stattdessen auf das Zahnradsymbol (Arbeitsbereich konfigurieren) neben Konfiguration.

   

2. Geben Sie in der Befehlspalette als Databricks-Host Ihre arbeitsbereichsspezifische URL ein, z. B https://adb-1234567890123456.7.azuredatabricks.net. Betätigen Sie anschließend die Eingabetaste.

3. Wählen Sie Azure CLI aus.