CURRENT_INSTANCE_ROLES

简介

CURRENT_INSTANCE_ROLES

函数用于获取当前用户在实例（Instance）级别拥有的角色列表。该函数不需要任何参数，返回

ARRAY<STRING>

类型，每个元素为一个实例级角色名称。

与

CURRENT_ROLES()

的区别：

CURRENT_ROLES()

返回当前 Workspace 级别的角色，结果为逗号分隔的字符串；

CURRENT_INSTANCE_ROLES()

返回 Instance 级别的角色，结果为字符串数组。

语法

CURRENT_INSTANCE_ROLES()

返回结果

ARRAY<STRING>

，每个元素为当前用户在实例级别拥有的一个角色名称。结果顺序不保证。

使用示例

查询当前用户的实例级角色列表：

SELECT CURRENT_INSTANCE_ROLES();

执行结果示例：

["instance_sre","instance_datasource_admin","instance_admin"]

注意事项

• 返回的是 Instance 级别角色，不包含 Workspace 级别角色。如需查看 Workspace 级别角色，使用

  CURRENT_ROLES()

  CURRENT_ROLES()
  。
• 函数每次执行返回的角色集合取决于当前会话用户，示例中的角色名仅供参考，实际返回值因用户权限而异。
• 结果为

  ARRAY<STRING>

  ARRAY<STRING>
  类型，可与数组函数（如

  ARRAY_CONTAINS

  ARRAY_CONTAINS
  ）配合使用。

相关函数

• CURRENT_USER()

  CURRENT_USER()
  ：返回当前会话的用户名称

• CURRENT_ROLES()

  CURRENT_ROLES()
  ：返回当前用户在 Workspace 级别拥有的角色（逗号分隔字符串）