user_identity_attribute_values Funktion

Gilt für:Angekreuzt ja, Databricks, SQL, angekreuzt ja, 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ändiger STRING Ausdruck. Der einzige unterstützte Wert lautet session_user().
  • attributeName: Ein Ausdruck, der ein Identitätsattribut benennt STRING . 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 principal nicht der Session-Benutzer ist, löst UNSUPPORTED_FEATURE.IDENTITY_ATTRIBUTES_NON_SESSION_USERAzure Databricks .
  • Wenn principal keine Konstante ist, erhebt Azure Databricks NON_FOLDABLE_ARGUMENT.
  • Wenn attributeName ein bestehendes Identitätsattribut benannt ist NULL oder nicht, löst IDENTITY_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 ohne department Wert ausgeblendet, sodass der Zugriff standardmäßig verweigert wird. NOT array_contains(..., 'contractor') Zeigt Benutzern ohne userType Wert 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);