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.
Ein Scope-Modifikator grenzt einen API-Scope auf eine Teilmenge seiner Operationen ein. Um einen Modifier hinzuzufügen, fügen Sie ihn zum Beispiel clusters:readdem Scope-Namen nach einem Doppelpunkt an. Ein Scope ohne Modifikator erlaubt jede Operation im Scope.
Sie können Bereichsmodifikatoren in Folgendem verwenden:
- Abgegrenzte persönliche Zugriffstoken
- Begrenzte OAuth-Geheimnisse für Service-Principals
- Der Parameter
scopeeiner OAuth-Token-Anfrage, unabhängig davon, ob Sie sich als Benutzer authentifizieren, als Serviceprincipal authentifizieren oder einen Identitätsanbieter-Token mit einer Workload-Identitätsföderation austauschen
Für die vollständige Liste der Scopes und die API-Operationen, die jeder abdeckt, siehe API-Scopes.
Verfügbare Modifikatoren
-
:read: Erlaubt nur die Leseoperationen (GETundHEADAnfragen) des Scopes. Zum Beispiel erlaubt esclusters:read, Cluster aufzulisten und abzurufen, aber nicht, sie zu erstellen, zu bearbeiten oder zu löschen. -
:restricted-query: Erlaubt schreibgeschützte SQL-Abfragen. Dieser Modifikator gilt nur für den Scopesql. Ein Token mitsql:restricted-querykann mit der Statement Execution API sowie SQL-Treibern und -Connectoren Abfragen wieSELECTundDESCRIBEausführen. Es kann keine anderen SQL-APIs aufrufen, wie zum Beispiel das Listen von SQL-Warehouses. Anweisungen, die Objekte oder Daten ändern, schlagen fehl:- Anweisungen, die Objekte erstellen, ändern oder löschen, wie
CREATE TABLEundDROP TABLE, versagen mit[OP_NOT_SUPPORTED_READ_ONLY] ... is not supported in read-only session mode. SQLSTATE: 42KD1. - Anweisungen, die Daten wie
INSERTundUPDATEändern, versagen mit[INSUFFICIENT_PERMISSIONS] Insufficient privileges, selbst bei Tabellen, die Ihnen gehören.
- Anweisungen, die Objekte erstellen, ändern oder löschen, wie
Um Modifikatoren zu kombinieren, fügen Sie beides hinzu: sql:read:restricted-query ermöglicht die Lesevorgänge des sql-Scopes, wie das Auflisten von SQL-Warehouses, sowie schreibgeschützte Abfragen.
Wählen Sie eine Zugriffsstufe in der Benutzeroberfläche aus
Wenn Sie ein persönliches Zugriffstoken oder ein OAuth-Geheimnis in der Arbeitsbereichsoberfläche generieren, wählen Sie nach Hinzufügen eines Bereichs dessen Zugriffsstufe aus. Die Zugriffsstufe legt den Modifikator fest:
| Zugriffsebene | Gewährter Geltungsbereich |
|---|---|
| Lesen | <scope>:read |
| Lesen + Schreiben |
<scope> (kein Modifikator) |
Eingeschränkte Abfrage (sql nur) |
sql:restricted-query |
Lesen + Eingeschränkte Abfrage (sql nur) |
sql:read:restricted-query |
Lesen + Eingeschränkte Abfrage + Schreiben (sql nur) |
sql (kein Modifikator) |
Verwenden Sie Modifikatoren mit persönlichen Zugriffstoken
Mit der Token-API fügen Sie jeden Scope mit seinen Modifikatoren als ein Element des Arrays scopes ein. Persönliche Zugangstoken unterstützen all-apis:readnicht. Um vollen Arbeitsbereichszugriff zu gewähren, verwenden Sie ein leeres scopes Array (das all-apis Scope). Siehe Gescopte persönliche Zugriffstoken.
Verwenden Sie Modifikatoren mit OAuth
Sie können ein OAuth-Geheimnis des Serviceprinzipals mit Modifikatoren an Scopes binden und ein OAuth-Zugriffstoken mit Modifikator-Scopes anfordern. Ein Access Token darf die Scopes des Secrets, aus dem er ausgestellt wurde, nicht überschreiten, außer bei einem Secret mit dem authentication-Scope. Siehe Scoped OAuth Secrets. OAuth akzeptiert all-apis:readaußerdem , was Leseoperationen auf jeder API ermöglicht, für die der Principal autorisiert ist.
Um einen Token mit Modifikatoren anzufordern, listen Sie die Scopes im scope Parameter der Token-Anfrage auf, getrennt durch Leerzeichen. Trennen Sie in der Autorisierungs-URL des User-to-Machine-Flows stattdessen die Scopes mit +.