Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL
Databricks Runtime 19 e superiori
Importante
Questa funzione legge gli attributi identità, che sono in Beta. Prima di poterlo utilizzare, un amministratore dell'account deve abilitare l'anteprima della Lista di Controllo Attributi Identità dalla pagina Anteprime della console account e fornire attributi di identità per i tuoi utenti. Vedi Attributi di identità.
Restituisce i valori di un attributo identitydell'utente della sessione.
Utilizza questa funzione nei UDF del filtro per righe per filtrare le righe in base agli attributi dell'utente che effettua la riquisizione, come il suo dipartimento o paese. Per applicare il filtro su tabelle, fai riferimento all'UDF in una policy di filtro per righe ABAC.
Sintassi
user_identity_attribute_values(principal, attributeName)
Arguments
-
principal: Un'espressione costanteSTRING. L'unico valore supportato èsession_user(). -
attributeName: Un'espressioneSTRINGche nomina un attributo identità. Il nome non deve necessariamente essere una costante, quindi può essere una colonna o un parametro SQL UDF. I nomi sono sensibili alla distinzione tra maiuscole e minuscole. Per gli attributi disponibili, vedi Attributi identità.
Returns
Un non annullabile ARRAY<STRING>.
Se l'utente non ha valore per attributeName, la funzione restituisce un array vuoto.
Condizioni di errore
- Se
principalnon è l'utente della sessione, Azure Databricks sollevaUNSUPPORTED_FEATURE.IDENTITY_ATTRIBUTES_NON_SESSION_USER. - Se
principalnon è una costante, Azure Databricks aumenta NON_FOLDABLE_ARGUMENT. - Se
attributeNameèNULLo non nomina un attributo identità esistente, Azure Databricks sollevaIDENTITY_ATTRIBUTE_NOT_FOUND. Questo include nomi che differiscono solo in caso di caso, come'Department'.
Notes
- La funzione restituisce gli attributi dell'utente che esegue la query. All'interno di una vista o di un UDF SQL, restituisce gli attributi dell'utente che interroga la vista o che chiama l'UDF, non del proprietario.
- Se utilizzi la funzione in un filtro di riga UDF, scrivi la condizione del filtro in modo che un array vuoto neghi l'accesso. Ad esempio,
array_contains(..., 'HR')nasconde righe agli utenti senzadepartmentvalore, negando quindi l'accesso di default.NOT array_contains(..., 'contractor')Mostra righe agli utenti senzauserTypevalore, quindi concede l'accesso di default. - Usa funzioni dell'array come array_contains o arrays_overlap per testare il risultato, invece di presumere che l'array abbia esattamente un elemento.
- Non puoi utilizzare la funzione in una vista condivisa tramite OpenSharing.
- Per verificare quali valori di attributo la funzione restituisce per te, chiamalo direttamente in una query, ad
SELECT user_identity_attribute_values(session_user(), 'department')esempio .
Examples
> 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);