user_identity_attribute_values Funzione

Si applica a:spuntato sì Databricks SQL contrassegnato sì 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 costante STRING . L'unico valore supportato è session_user().
  • attributeName: Un'espressione STRING che 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 principal non è l'utente della sessione, Azure Databricks solleva UNSUPPORTED_FEATURE.IDENTITY_ATTRIBUTES_NON_SESSION_USER.
  • Se principal non è una costante, Azure Databricks aumenta NON_FOLDABLE_ARGUMENT.
  • Se attributeName è NULL o non nomina un attributo identità esistente, Azure Databricks solleva IDENTITY_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 senza department valore, negando quindi l'accesso di default. NOT array_contains(..., 'contractor') Mostra righe agli utenti senza userType valore, 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);