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.
Gilt für:
, Databricks, SQL,
, Databricks, Laufzeit 19 und höher.
Important
Diese Funktion liest Identitätsattribute, die sich in Beta befinden. Bevor Sie es verwenden können, muss ein Kontoadministrator die Vorschau der Liste der Identitätsattributkontrollliste auf der Seite Vorschauen der Kontokonsole aktivieren und Identitätsattribute für Ihre Benutzer bereitstellen. Siehe Identitätsattribute.
Gibt die Werte eines Identitätsattributs des Sitzungsbenutzers zurück.
Verwenden Sie diese Funktion in Zeilenfilter-UDFs, um Zeilen basierend auf den Attributen des abfragenden Benutzers zu filtern, wie etwa deren Abteilung oder Land. Um den Filter über Tabellen hinweg anzuwenden, verweisen Sie in einer ABAC-Zeilenfilterrichtlinie auf den UDF.
Syntax
user_identity_attribute_values(principal, attributeName)
Arguments
-
principal: Ein ständigerSTRINGAusdruck. Der einzige unterstützte Wert lautetsession_user(). -
attributeName: Ein Ausdruck, der ein Identitätsattribut benenntSTRING. Der Name muss keine Konstante sein, er kann also eine Spalte oder ein SQL-UDF-Parameter sein. Bei Namen wird die Groß-/Kleinschreibung beachtet. Für die verfügbaren Attribute siehe Identitätsattribute.
Rücklieferungen
Ein nicht-nullierbares ARRAY<STRING>.
Wenn der Benutzer keinen Wert für attributeNamehat, gibt die Funktion ein leeres Array zurück.
Fehlerbedingungen
- Wenn
principalnicht der Session-Benutzer ist, löstUNSUPPORTED_FEATURE.IDENTITY_ATTRIBUTES_NON_SESSION_USERAzure Databricks . - Wenn
principalkeine Konstante ist, erhebt Azure Databricks NON_FOLDABLE_ARGUMENT. - Wenn
attributeNameein bestehendes Identitätsattribut benannt istNULLoder nicht, löstIDENTITY_ATTRIBUTE_NOT_FOUNDAzure Databricks . Dies umfasst Namen, die sich nur in Großschreibung unterscheiden, wie zum Beispiel'Department'.
Notizen
- Die Funktion gibt die Attribute des Benutzers zurück, der die Abfrage ausführt. Innerhalb einer Ansicht oder eines SQL-UDF gibt es die Attribute des Benutzers zurück, der die Ansicht abfragt oder die UDF aufruft, nicht des Eigentümers.
- Wenn Sie die Funktion in einem Zeilenfilter-UDF verwenden, schreiben Sie die Filterbedingung so, dass ein leeres Array den Zugriff verweigert. Zum Beispiel
array_contains(..., 'HR')werden Zeilen für Benutzer ohnedepartmentWert ausgeblendet, sodass der Zugriff standardmäßig verweigert wird.NOT array_contains(..., 'contractor')Zeigt Benutzern ohneuserTypeWert Zeilen an, sodass standardmäßig Zugriff gewährt wird. - Verwenden Sie Arrayfunktionen wie array_contains oder arrays_overlap , um das Ergebnis zu testen, anstatt davon auszugehen, dass das Array genau ein Element hat.
- Sie können die Funktion nicht in einer über OpenSharing geteilten Ansicht verwenden.
- Um zu überprüfen, welche Attributwerte die Funktion für Sie zurückgibt, rufen Sie sie beispielsweise
SELECT user_identity_attribute_values(session_user(), 'department')direkt in einer Abfrage auf.
Beispiele
> SELECT user_identity_attribute_values(session_user(), 'department');
["Finance"]
-- The user has no value for the attribute
> SELECT user_identity_attribute_values(session_user(), 'costCenter');
[]
-- Attribute names are case-sensitive
> SELECT user_identity_attribute_values(session_user(), 'Department');
Error: IDENTITY_ATTRIBUTE_NOT_FOUND
-- The function only works for the session user's attributes
> SELECT user_identity_attribute_values('alice@example.com', 'department');
Error: UNSUPPORTED_FEATURE.IDENTITY_ATTRIBUTES_NON_SESSION_USER
-- Row filter UDF that returns only rows for the user's country
> CREATE FUNCTION main.sales.country_filter(country STRING)
RETURN array_contains(user_identity_attribute_values(session_user(), 'country'), country);
-- Apply the UDF to every table in the schema that has a column tagged 'country'
> CREATE POLICY filter_by_user_country
ON SCHEMA main.sales
ROW FILTER main.sales.country_filter
TO `account users`
FOR TABLES
MATCH COLUMNS has_tag('country') AS country_col
USING COLUMNS (country_col);