current_oauth_custom_identity_claim funkcja

Dotyczy do:zaznaczyć tak, Databricks SQL oznaczony tak, Databricks Runtime 19 i wyższe

Zwraca roszczenie o niestandardową tożsamość w tokenie OAuth, który uwierzytelnił bieżącą sesję. Aplikacja dodaje roszczenie, gdy żąda tokena OAuth dla podmiotu usługi. Użyj tej funkcji w dynamicznym widoku lub funkcji filtra wierszowego, aby filtrować dane dla każdego użytkownika końcowego aplikacji. Zobacz Filtruj dane na użytkownika końcowego z roszczeniami OAuth o niestandardową tożsamość.

Syntax

current_oauth_custom_identity_claim()

Arguments

Ta funkcja nie przyjmuje żadnych argumentów.

Returns

Element STRING.

Jeśli sesja nie została uwierzytelniona tokenem OAuth z niestandardowym roszczeniem tożsamości, funkcja zwraca NULL.

Notes

  • Zapisz każdy filtr korzystający z tej funkcji tak, aby roszczenie NULL nie pasowało do żadnych wierszy. Użyj zwykłej równości, takiej jak customer_name = current_oauth_custom_identity_claim(). Nie używaj IS NULL sprawdzania, coalesce, ani operatora <=> równości zerowej na roszczeniu. Zobacz Zapisz filtry, które pasują do żadnych wierszy, gdy roszczenie jest NULL.
  • Traktuj to twierdzenie wyłącznie jako wartość do porównania. Nie używaj go jako wzorca w RLIKE, jako nazwy obiektu w IDENTIFIER, ani jako części tekstu SQL, który się uruchamia.EXECUTE IMMEDIATE
  • Azure Databricks nie szyfruje ani nie interpretuje tego twierdzenia. Każdy, kto posiada token, może go przeczytać.

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();