类别：

上下文函数 （通用）

IS_GROUP_ACTIVATED（SYS_CONTEXT 函数）

如果在给定上下文激活代表 组织用户组 的角色，则返回 VARCHAR 值 'TRUE'。

另请参阅：

SYS_CONTEXT（SNOWFLAKE$ORGANIZATION 命名空间）、IS_GROUP_IMPORTED（SYS_CONTEXT 函数）、IS_USER_IMPORTED（SYS_CONTEXT 函数）

语法

SYS_CONTEXT(
  'SNOWFLAKE$ORGANIZATION' ,
  'IS_GROUP_ACTIVATED' ,
  '<context>' ,
  '<group_name>'
)
Copy

实参

'SNOWFLAKE$ORGANIZATION'

指定您要调用函数以返回有关当前组织的上下文信息。

'IS_GROUP_ACTIVATED'

调用 IS_GROUP_ACTIVATED 函数。

'context'

指定要检查的执行上下文。您可以指定以下值中的一个：

  • SESSION：选择使用 时默认使用的角色和仓库。检查组织群组角色是否位于当前会话的主要角色或次要角色的角色层次结构中。如果该角色位于角色层次结构中，则该函数返回 'TRUE'。

  • ACTIVE：选择使用 时默认使用的角色和仓库。检查组织群组角色是否位于当前调用上下文的角色层次结构中。

    例如，在调用所有者权限存储过程时，该过程由所有者角色执行。如果组织群组角色位于所有者角色的角色层次结构中，则该函数返回 'TRUE'。

'group_name'

指定要检查的组织用户组的名称。

返回

该函数返回以下 VARCHAR 值之一：

  • 如果组织用户组角色在 context 指定的上下文中激活，则值为 'TRUE'。

  • 如果组织用户组角色未在该上下文中激活，或者该组不是有效的组织用户组，则值为 'FALSE'。

要将此返回值与 BOOLEAN 值 TRUE 或 FALSE 进行比较，请将返回值 转换 为 BOOLEAN。例如：

SELECT SYS_CONTEXT('SNOWFLAKE$ORGANIZATION', 'IS_GROUP_ACTIVATED', 'SESSION', 'my_group_name')::BOOLEAN = TRUE;
Copy

使用说明

示例

如果组织用户组的 my_group_name 角色位于会话主要或次要角色的角色层次结构中，则以下示例返回 'TRUE'：

SELECT SYS_CONTEXT('SNOWFLAKE$ORGANIZATION', 'IS_GROUP_ACTIVATED', 'SESSION', 'my_group_name');
Copy
语言: 中文