Funzione current_oauth_custom_identity_claim

Si applica a:spunta sì Databricks SQL spuntato sì Databricks Runtime 19 e superiori

Restituisce la rivendicazione di identità personalizzata nel token OAuth che ha autenticato la sessione corrente. Un'applicazione aggiunge la richiesta quando richiede un token OAuth per un principale di servizio. Usa questa funzione in una vista dinamica o in una funzione filtro per righe per filtrare i dati per ogni utente finale dell'applicazione. Vedi Filtra i dati per utente finale con richieste di identità personalizzate OAuth.

Syntax

current_oauth_custom_identity_claim()

Arguments

Questa funzione non accetta argomenti.

Returns

Un oggetto STRING.

Se la sessione non è stata autenticata con un token OAuth che trasporta una richiesta di identità personalizzata, la funzione restituisce NULL.

Note

  • Scrivi ogni filtro che utilizza questa funzione in modo che una NULL reclamazione non corrisponda a nessuna riga. Usa l'uguaglianza semplice, come customer_name = current_oauth_custom_identity_claim(). Non usare IS NULL controlli, coalesce, o l'operatore <=> di uguaglianza null-safe sulla rivendicazione. Vedi i filtri di scrittura che non corrispondono a nessuna riga quando la richiesta è NULLA.
  • Usa la richiesta solo come valore per confrontare. Non usarlo come pattern in RLIKE, come nome di oggetto in IDENTIFIER, o come parte del testo SQL che EXECUTE IMMEDIATE gira.
  • Azure Databricks non cripta né interpreta la rivendicazione. Chiunque abbia il gettone può leggerlo.

Examples

-- A token created with custom_claim=acme
> SELECT current_oauth_custom_identity_claim();
 acme

-- A token without a custom claim
> SELECT current_oauth_custom_identity_claim();
 NULL

-- A dynamic view that returns only the caller's rows
> CREATE VIEW main.sales.customer_orders AS
    SELECT order_id, customer_name, product, order_date
    FROM main.sales.orders
    WHERE customer_name = current_oauth_custom_identity_claim();