GROUPS

認証済みの呼び出し元が所属するディレクトリグループを JSON 配列として返します。アクセス管理を有効にして開始したセッションが必要です。StackQL v1.0 以降で利用できます。

関連項目：
[WHOAMI] [ アクセス管理 ]

---

構文

SELECT GROUPS() [ AS <alias> ];

引数

なし。

戻り値

現在の文に対して取得したプリンシパルディレクトリのスナップショットから、グループ ID の JSON 配列（たとえば ["readers"]）を返します。メンバーシップは文ごとに更新されるため、メンバーシップの取り消しは次の文で反映されます。--access.config を指定せずに開始したセッションでは、この関数は失敗します。

---

例

確立された ID を確認する

2 つの関数を組み合わせると、呼び出し元のプリンシパル ID と現在のディレクトリグループがわかります。メンバーシップは文ごとに新たに読み取られるため、ディレクトリの変更後にこれを実行すると、その変更がセッションから見えることを確認できます。

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