# GROUPS

> الدالة GROUPS في StackQL: إرجاع مجموعات الدليل للجهة المستدعية المصادق عليها كمصفوفة JSON عند تمكين إدارة الوصول.

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

تعيد عضويات مجموعات الدليل للجهة المستدعية المصادق عليها كمصفوفة JSON.  تتطلب جلسة بدأت مع تمكين [إدارة الوصول](/command-line-usage/access-management).  متاحة في StackQL من الإصدار `v1.0` فصاعدًا.

راجع أيضًا:  
[[` WHOAMI `]](/language-spec/functions/session/whoami) [[ إدارة الوصول ]](/command-line-usage/access-management)

* * * 

## بناء الجملة

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

## الوسيطات

لا يوجد.

## القيمة المرجعة

تعيد مصفوفة JSON بمعرفات المجموعات من لقطة دليل كيانات الأمان المأخوذة للجملة الحالية، على سبيل المثال `["readers"]`.  يتم تحديث العضوية لكل جملة، لذلك ينعكس أي إبطال في الجملة التالية.  تفشل الدالة في جلسة بدأت بدون `--access.config`.

* * *

## أمثلة

### فحص الهوية التي تم تأسيسها

تعرض الدالتان معًا معرف كيان الأمان للجهة المستدعية ومجموعات الدليل الحالية الخاصة بها.  ولأن قراءة العضوية تتم من جديد لكل جملة، فإن تشغيل هذا الاستعلام بعد تغيير في الدليل يؤكد أن التغيير مرئي للجلسة.

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