current_oauth_custom_identity_claim functie

Van toepassing op:vinkje gemarkeerd ja Databricks SQL vinkje gemarkeerd ja Databricks Runtime 19 en hoger

Geeft de custom identity claim terug in het OAuth-token dat de huidige sessie authenticeerde. Een applicatie voegt de claim toe wanneer zij een OAuth-token voor een serviceprincipal aanvraagt. Gebruik deze functie in een dynamische weergave of rijfilterfunctie om gegevens te filteren voor elke eindgebruiker van de applicatie. Zie Filter data per eindgebruiker met OAuth aangepaste identiteitsclaims.

Syntax

current_oauth_custom_identity_claim()

Arguments

Deze functie heeft geen argumenten.

Returns

A STRING.

Als de sessie niet is geauthenticeerd met een OAuth-token dat een custom identity claim draagt, geeft de functie .NULL

Opmerkingen

  • Schrijf elk filter dat deze functie gebruikt zodat een NULL claim overeenkomt met geen enkele rij. Gebruik eenvoudige gelijkheid, zoals customer_name = current_oauth_custom_identity_claim(). Gebruik geen IS NULL controles, coalesce, of de null-safe gelijkheidsoperator <=> op de claim. Zie Schrijffilters die overeenkomen met geen rijen wanneer de claim NULL is.
  • Gebruik de claim alleen als waarde om te vergelijken. Gebruik het niet als patroon in RLIKE, als objectnaam in IDENTIFIER, of als onderdeel van de SQL-tekst die EXECUTE IMMEDIATE draait.
  • Azure Databricks versleutelt of interpreteert de claim niet. Iedereen die de token in handen heeft, kan het lezen.

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();
  • Laatst bijgewerkt om