snowflake.snowpark.functions.invoker_role¶

snowflake.snowpark.functions.invoker_role() → Column[source] (https://github.com/snowflakedb/snowpark-python/blob/v1.48.0/src/snowflake/snowpark/_functions/scalar_functions.py#L373-L389)¶

Returns the name of the role that was active when the current stored procedure or user-defined function was called.

Returns:: A Snowflake Column object representing the name of the active role.
Return type:: Column

Example:

>>> df = session.create_dataframe([1])
>>> result = df.select(invoker_role()).collect()
>>> assert len(result) == 1
>>> assert isinstance(result[0]["INVOKER_ROLE()"], str)
>>> assert len(result[0]["INVOKER_ROLE()"]) > 0