Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können eine Rolle mit rollenbasierter Zugriffskontrolle (RBAC) in Azure Databricks auf verschiedene Weise übernehmen. Die Berechtigungen der Rolle gelten für die Anfragen oder Rechenvorgänge, die in dieser Rolle ausgeführt werden. Der Umfang hängt von der Methode ab: Der Rollenwechsel im Arbeitsbereich verändert die Browsersitzung, während die Authentifizierung eines Databricks-CLI-Profils oder die Verbindung mit Gruppen-Compute dieses Profil oder die Rechensitzung beeinflusst.
Requirements
Über eine Rolle zu übernehmen, müssen Sie dafür die Übernehmen-Berechtigung haben. Sie können die Übernehmen-Berechtigung direkt erhalten, über eine Gruppe mit der Übernehmen-Berechtigung oder über deine Mitgliedschaft in der Gruppe, der die Rolle zugewiesen ist. Die Rolle muss dem Arbeitsbereich mit den benötigten Zugriffsberechtigungen zugewiesen werden. Siehe Arbeitsbereichszugriff konfigurieren.
Important
Rollen erben Berechtigungen von ihren übergeordneten Gruppen. Standardmäßig erben deine Rollen auch Berechtigungen, die der users-Systemgruppe des Arbeitsbereichs und der account users-Systemgruppe des Kontos gewährt werden. Die Änderung einer gemeinsamen Zuweisung betrifft andere Nutzer und Rollen, die sie erben. Siehe Wie Rollenberechtigungen angewendet werden. Zugriffsrechte werden separat konfiguriert. Siehe Arbeitsbereichszugriff konfigurieren.
Rollenwechsler im Arbeitsbereich
Verwenden Sie den Rollenwechsel , um eine Rolle im gesamten Arbeitsbereich anzunehmen. Alle Zugriffe, Berechtigungen, Eigentumsrechte und Aktionen entsprechen für die Dauer der Sitzung der Rolle.
- Klicken Sie im Azure Databricks Arbeitsbereich auf den Arbeitsbereichsnamen in der oberen rechten Ecke der oberen Leiste.
- Zeigen Sie mit der Maus auf den aktuellen Arbeitsbereich (das oberste Element im Menü), um das Rollenwechsel-Untermenü anzuzeigen.
- Klicken Sie im Untermenü auf die Rolle, die Sie annehmen möchten.
Die Benutzeroberfläche wird neu geladen, und die unter dem Arbeitsbereichsnamen angezeigte Identität ändert sich in die von Ihnen ausgewählte Rolle.
Um zur Benutzeridentität zurückzukehren, öffnen Sie dasselbe Untermenü, und wählen Sie Ihren Benutzernamen aus. Wenn du den Arbeitsbereich durch die Übernahme einer Rolle betreten hast, weil du dem Arbeitsbereich nicht zugewiesen bist, ist dein Benutzername nicht zur Auswahl verfügbar. Siehe Wann Sie eine Rolle übernehmen müssen, um einen Arbeitsbereich zu betreten.
Note
Wenn Sie das Untermenü zum Rollenwechsel nicht sehen, überprüfen Sie, ob Sie Mitglied einer Gruppe sind, die dem Arbeitsbereich zugewiesen ist, oder ob Ihnen die Assume-Berechtigung für eine dem Arbeitsbereich zugewiesene Gruppe erteilt wurde. Siehe Verwalten von Berechtigungen für eine Gruppe.
Wenn du eine Rolle übernehmen musst, um einen Arbeitsbereich zu betreten
Wenn Sie weder direkt noch über Gruppenmitgliedschaft einem Arbeitsbereich zugewiesen sind, aber die Berechtigung „Übernehmen“ für eine Gruppe haben, die dem Arbeitsbereich zugewiesen ist, müssen Sie eine Rolle übernehmen, um den Arbeitsbereich zu betreten. Das hängt von deiner eigenen Arbeitsbereichszuweisung ab, nicht von einer Arbeitsbereich-Einstellung, sodass andere Benutzer, die demselben Arbeitsbereich zugewiesen sind, sich weiterhin als sie selbst anmelden.
Anweisungen zum Einrichten und zur Rollenübernahme finden Sie unter Tutorial: Verpflichten Sie Benutzer, eine Rolle für den Arbeitsbereichszugriff zu übernehmen.
Arbeitsbereichs-URL (Direktlink)
Sie können eine Rolle direkt über die Arbeitsbereichs-URL übernehmen, indem Sie den Abfrageparameter aid („assume ID“) auf die ID der Gruppe setzen: aid=<group-id> Durch das Öffnen dieser URL werden Sie wie gewohnt mit Ihrer Benutzeridentität authentifiziert; anschließend wird automatisch die Rolle übernommen, sodass Sie den Rollenwechsel nicht verwenden müssen.
Um beispielsweise einen Arbeitsbereich zu öffnen, der bereits die Funktion einer Rolle hat:
https://<workspace-url>/?o=<workspace-id>&aid=<group-id>
Dies ist nützlich, um ein Lesezeichen zu setzen oder einen Link zu teilen, der direkt bei einer Rolle landet. Azure Databricks behält den aid Parameter bei, während Sie sich innerhalb des Arbeitsbereichs bewegen, sodass Sie für die Dauer der Sitzung in dieser Rolle bleiben. Der Wechsel zu einem anderen Arbeitsbereich löscht es. Die Rolle ist eine Kontengruppe und muss jedem Arbeitsbereich zugewiesen werden, in dem Sie sie nutzen.
Um die ID einer Gruppe abzurufen, verwenden Sie die Account Groups API. Um Rollen zu wechseln oder nach dem Öffnen des Links zur Benutzeridentität zurückzukehren, verwenden Sie den Rollenwechsel.
Einer Gruppe zugewiesene dedizierte Rechenkapazität
Wenn Sie sich mit einer dedizierten Compute-Ressource verbinden, die einer Gruppe zugewiesen ist, nutzen Operationen, die den zugewiesenen Prinzipal des Compute verwenden, die Berechtigungen dieser Gruppe. Du musst nicht zuerst in der Arbeitsbereichs-UI die Rolle wechseln.
Der Arbeitsbereich muss für Unity Catalog aktiviert sein, und das Compute muss Databricks Runtime 15.4 oder höher verwenden. Die Gruppe benötigt außerdem Zugriff auf die Notebooks und andere Ressourcen, die auf dem Compute verwendet werden. Operationen, die von der Notebook-Umgebung verwaltet werden, wie z. %runB. , verwenden die Berechtigungen des Benutzers und nicht die der Gruppe. Siehe Zugriff auf dedizierte Rechengruppen für Einrichtung und Einschränkungen.
Databricks CLI
Wenn Sie OAuth user-to-machine (U2M)-Authentifizierung mit der Databricks-CLI verwenden, öffnet dies Ihren Webbrowser, um den Authentifizierungsprozess abzuschließen. Wenn Sie die Berechtigung „Assume“ für eine oder mehrere Rollen haben, wählen Sie im Browser, ob Sie sich als eigene Benutzeridentität oder als eine dieser Rollen authentifizieren. Wenn du nicht dem Arbeitsbereich zugewiesen bist, kannst du dich nicht mit deiner eigenen Identität authentifizieren und musst eine Rolle auswählen. Siehe Wann Sie eine Rolle übernehmen müssen, um einen Arbeitsbereich zu betreten. Installiere die Databricks-CLI, bevor du beginnst. Siehe Installieren oder Aktualisieren der Databricks CLI. Um den Login-Flow zu starten, führen Sie aus:
databricks auth login --host <workspace-url> --profile <profile-name>
Nachdem Sie den Login-Flow abgeschlossen haben, speichert die Databricks-CLI ein Konfigurationsprofil und verwaltet kurzlebige OAuth-Tokens dafür. Befehle, die dieses Profil verwenden, werden mit der von dir gewählten Rolle ausgeführt. Das Wechseln der Rollen in der Arbeitsbereich-Benutzeroberfläche ändert nicht die Identität dieses Profils. Beispiel:
databricks warehouses list --profile <profile-name>
Details zur Authentifizierung der Databricks-CLI finden Sie unter Authentifizierung für die Databricks-CLI.
API (OAuth-Zugriffstoken)
Sie können ein OAuth-Zugriffstoken auf Arbeitsbereichsebene generieren, um in einer Rolle API-Aufrufe auszuführen. Die OAuth-Scopes des Tokens begrenzen, welche APIs es aufrufen kann, und die Berechtigungen der Rolle bestimmen seinen Zugriff auf Ressourcen.
Um ein rollenbezogenes Token zu generieren, führen Sie wie in databricks auth login beschrieben aus und wählen Sie die Rolle in Ihrem Webbrowser aus. Rufen Sie ein Zugriffstoken für das Profil ab:
databricks auth token --profile <profile-name>
Verwenden Sie access_token der Antwort im Authorization: Bearer Header der API-Anforderung. Ein Token, das in eine andere Anwendung kopiert wird, aktualisiert sich nicht selbst. Siehe Databricks Auth Token.
Für einen manuellen U2M-Flow fügen Sie der Workspace-Autorisierungs-URL assume_group=<group-id> hinzu. Siehe Einen Autorisierungscode auf Arbeitsbereichsebene generieren.
Für einen unbeaufsichtigten Prozess, der einen Service Principal verwendet, fügen Sie assume_group=<group-id> in die Machine-to-Machine (M2M)-Workspace-Token-Anfrage ein. Sowohl der Service Principal als auch die Rolle müssen dem Arbeitsbereich zugewiesen werden. Tokenanfragen auf Kontoebene unterstützen keine Rollenübernahme. Siehe Rolle übernehmen und Tutorial: Den Zugriff eines KI-Agenten mit RBAC eingrenzen.
BI-Tools von Drittanbietern
BI-Tools von Drittanbietern, die OAuth unterstützen (z. B. Tableau und Power BI), können sich mit einer Rolle autorisieren. Nach der Autorisierung verwenden Abfragen, die über diese Verbindung gesendet werden, die Berechtigungen der Rolle. Die Rolle benötigt die Berechtigung, die ausgewählte Rechenleistung zu verwenden und auf die abgerufenen Daten zuzugreifen. Befolgen Sie die vom Tool unterstützte Authentifizierungs- und Rechenkonfiguration. Siehe Databricks ODBC- und JDBC-Treiber.
Für bekannte Probleme, die BI-Tools und Treiber betreffen, wenn sie als Rolle fungieren, siehe Bekannte Probleme.
Was ändert sich, wenn Sie eine Rolle annehmen
Wenn Sie den Workspace-Rollenwechsel verwenden:
- Notebooks und Abfragen: Werden als die betreffende Rolle ausgeführt. Die Berechtigungen der Rolle steuern interaktive Abfragen und Unity Catalog-Operationen, die als diese Rolle ausgeführt werden.
- Jobs: Wenn Sie einen Job erstellen, während Sie in der Rolle agieren, ist die Einstellung Ausführen als des Jobs die Rolle. Sie können das Ausführen als eines Jobs auch auf eine Gruppe festlegen, ohne diese erst anzunehmen. Siehe „Ausführen als“ für eine Gruppe festlegen.
- Workspace-Assets: Die Rolle besitzt alle Assets, die du erstellst (Notizbücher, SQL-Abfragen, SQL-Warehouses, Jobs).
-
Audit-Logs: Unterscheide die Identität, die ein Ereignis ausgelöst hat (
identity_metadata.run_by) und die für die Autorisierung verwendete Identität (identity_metadata.run_as). Bei interaktiven Anfragen identifizieren diese jeweils Ihre Benutzeridentität und die Rolle. Job-Workloads verzeichnen den Anwendungsdienstprinzipal des Job-Services alsrun_by. Siehe Audit Attribution verifizieren.
Job-Ausführungen verwenden das konfigurierte Ausführen als Identität. Abfrageaufgaben können auch von den Sharing-Einstellungen der SQL-Ressource abhängen, und dedizierte Compute-Ressourcen können ihren zugewiesenen Prinzipal verwenden. Siehe „Ausführen als“ für eine Gruppe festlegen.
Informationen zu Features, die nicht unterstützt oder nur teilweise unterstützt werden, wenn sie als Rolle fungieren, finden Sie unter Einschränkungen der rollenbasierten Zugriffssteuerung (Role-based Access Control, RBAC).
Zusätzliche Ressourcen
| Ressource | Description |
|---|---|
| Einschränkungen der rollenbasierten Zugriffssteuerung (RBAC) | Erfahren Sie, welche Azure Databricks-Funktionen nicht oder nur teilweise unterstützt werden, wenn sie eine bestimmte Rolle ausüben. |
| Kontrolliere das Teilen von Workspace-Assets mit RBAC | Verhindern, dass Nutzer, die als Rolle fungieren, Arbeitsbereichs-Assets teilen, die der Rolle gehören. |