# GROUPS

> Función GROUPS en StackQL: devolver los grupos del directorio del llamador autenticado como un array JSON cuando la gestión de accesos está habilitada.

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

Devuelve las pertenencias a grupos del directorio del llamador autenticado como un array JSON.  Requiere una sesión iniciada con la [gestión de accesos](/command-line-usage/access-management) habilitada.  Disponible a partir de StackQL `v1.0`.

Consulte también:  
[[` WHOAMI `]](/language-spec/functions/session/whoami) [[ Gestión de accesos ]](/command-line-usage/access-management)

* * * 

## Sintaxis

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

## Argumentos

Ninguno.

## Valor(es) devuelto(s)

Devuelve un array JSON de ID de grupo de la instantánea del directorio de principales tomada para la instrucción actual, por ejemplo `["readers"]`.  La pertenencia se actualiza con cada instrucción, de modo que la siguiente instrucción ya refleja una revocación.  La función falla en una sesión iniciada sin `--access.config`.

* * *

## Ejemplos

### Inspeccionar la identidad establecida

Las dos funciones juntas muestran el ID del principal del llamador y sus grupos actuales del directorio.  Como la pertenencia se lee de nuevo con cada instrucción, ejecutar esta consulta después de un cambio en el directorio confirma que el cambio es visible para la sesión.

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