跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

GROUPS

以 JSON 陣列傳回已驗證呼叫端的目錄群組成員資格。工作階段必須在啟用存取管理的情況下啟動。StackQL v1.0 及更新版本提供此函式。

另請參閱:
[WHOAMI] [ 存取管理 ]


語法​

SELECT GROUPS() [ AS <alias> ];

引數​

無。

傳回值​

傳回 JSON 陣列,內容為從目前陳述式所擷取之主體目錄快照中的群組 ID,例如 ["readers"]。成員資格會針對每個陳述式重新整理,因此撤銷會在下一個陳述式中反映出來。在未使用 --access.config 啟動的工作階段中,此函式會失敗。


範例​

檢查已建立的身分​

搭配使用這兩個函式,可顯示呼叫端的主體 ID 及其目前的目錄群組。由於每個陳述式都會重新讀取成員資格,在目錄變更後執行此查詢,即可確認工作階段看得到該變更。

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