# GROUPS

> Fungsi GROUPS di StackQL: mengembalikan grup direktori pemanggil yang terautentikasi sebagai array JSON saat manajemen akses diaktifkan.

Source: https://stackql.io/id/language-spec/functions/session/groups

Mengembalikan keanggotaan grup direktori pemanggil yang terautentikasi sebagai array JSON.  Memerlukan sesi yang dimulai dengan [manajemen akses](/command-line-usage/access-management) yang diaktifkan.  Tersedia mulai StackQL `v1.0`.

Lihat juga:  
[[` WHOAMI `]](/language-spec/functions/session/whoami) [[ Manajemen akses ]](/command-line-usage/access-management)

* * * 

## Sintaksis

```sql
SELECT GROUPS() [ AS <alias> ];
```

## Argumen

Tidak ada.

## Nilai yang dikembalikan

Mengembalikan array JSON berisi ID grup dari snapshot direktori prinsipal yang diambil untuk pernyataan saat ini, misalnya `["readers"]`.  Keanggotaan diperbarui untuk setiap pernyataan, sehingga pencabutan tercermin pada pernyataan berikutnya.  Fungsi ini gagal dalam sesi yang dimulai tanpa `--access.config`.

* * *

## Contoh

### Memeriksa identitas yang ditetapkan

Kedua fungsi ini bersama-sama menunjukkan ID prinsipal pemanggil dan grup direktorinya saat ini.  Karena keanggotaan dibaca ulang untuk setiap pernyataan, menjalankan kueri ini setelah perubahan direktori memastikan bahwa perubahan tersebut terlihat oleh sesi.

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