GROUPS

以 JSON 数组形式返回已通过身份验证的调用方的目录组成员身份。需要在启用访问管理的情况下启动会话。在 StackQL v1.0 及更高版本中可用。

另请参阅：
[WHOAMI] [ 访问管理 ]

---

语法

SELECT GROUPS() [ AS <alias> ];

参数

无。

返回值

返回由组 ID 构成的 JSON 数组，取自为当前语句生成的主体目录快照，例如 ["readers"]。成员身份在每条语句执行时刷新，因此撤销会在下一条语句中体现。在未使用 --access.config 启动的会话中，该函数会失败。

---

示例

查看已建立的身份

这两个函数一起显示调用方的主体 ID 及其当前的目录组。由于成员身份在每条语句执行时都会重新读取，在目录发生变化后运行此语句，可以确认该变化对会话可见。

SELECT whoami() AS principal, groups() AS memberships;