current_oauth_custom_identity_claim Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19 et supérieur

Retourne la revendication d’identité personnalisée dans le token OAuth qui a authentifié la session en cours. Une application ajoute la revendication lorsqu’elle demande un jeton OAuth pour un principal de service. Utilisez cette fonction dans une vue dynamique ou une fonction de filtre de ligne pour filtrer les données de chaque utilisateur final de l’application. Voir Filtrer les données par utilisateur final avec des revendications d’identité personnalisées OAuth.

Syntax

current_oauth_custom_identity_claim()

Arguments

Cette fonction ne prend pas d'arguments.

Returns

Un STRING.

Si la session n’a pas été authentifiée avec un jeton OAuth qui porte une revendication d’identité personnalisée, la fonction renvoie NULL.

Notes

  • Écrivez chaque filtre utilisant cette fonction afin qu’une NULL revendication ne corresponde à aucune ligne. Utilisez l’égalité simple, comme customer_name = current_oauth_custom_identity_claim(). N’utilisez IS NULL pas de chèques, coalesce, ni l’opérateur <=> d’égalité nul-sûre sur la revendication. Voir les filtres d’écriture qui ne correspondent à aucune ligne lorsque la revendication est NULL.
  • Utilisez la réclamation uniquement comme valeur pour comparer. Ne l’utilisez pas comme un motif dans RLIKE, comme nom d’objet dans IDENTIFIER, ni comme partie du texte SQL qui EXECUTE IMMEDIATE s’exécute.
  • Azure Databricks ne chiffre ni n'interprète la revendication. Quiconque détient le jeton peut le lire.

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