current_oauth_custom_identity_claim Función

Aplica a:con marca de verificación sí Databricks SQL marcado sí Databricks Runtime 19 y superiores

Devuelve la reclamación de identidad personalizada en el token OAuth que autenticó la sesión actual. Una aplicación añade la reclamación cuando solicita un token OAuth para un principal de servicio. Utiliza esta función en una vista dinámica o en una función de filtro de fila para filtrar datos de cada usuario final de la aplicación. Consulta Filtrar datos por usuario final con reclamaciones de identidad personalizadas de OAuth.

Syntax

current_oauth_custom_identity_claim()

Argumentos

Esta función no toma ningún argumento.

Returns

Un objeto STRING.

Si la sesión no se autenticó con un token OAuth que lleva una reclamación de identidad personalizada, la función devuelve NULL.

Notes

  • Escribe cada filtro que use esta función para que una NULL reclamación no coincida con ninguna fila. Utiliza la igualdad sencilla, como customer_name = current_oauth_custom_identity_claim(). No uses IS NULL cheques, coalesce, ni el operador <=> de igualdad nula-segura en la reclamación. Consulta los filtros de escritura que no coinciden con filas cuando la reclamación es NULL.
  • Usa la reclamación solo como valor para comparar. No lo uses como un patrón en RLIKE, como nombre de objeto en IDENTIFIER, ni como parte del texto SQL que EXECUTE IMMEDIATE se ejecuta.
  • Azure Databricks no cifra ni interpreta la afirmación. Cualquiera que tenga el token puede leerlo.

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();
  • Se actualizó por última vez el