Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

GROUPS

Retorna as associações a grupos de diretório do chamador autenticado como um array JSON. Requer uma sessão iniciada com o gerenciamento de acesso habilitado. Disponível a partir do StackQL v1.0.

Veja também:
[WHOAMI] [ Gerenciamento de acesso ]


Sintaxe​

SELECT GROUPS() [ AS <alias> ];

Argumentos​

Nenhum.

Valor(es) retornado(s)​

Retorna um array JSON de IDs de grupo do snapshot do diretório de principals obtido para a instrução atual, por exemplo ["readers"]. As associações são atualizadas a cada instrução, de modo que uma revogação se reflete na instrução seguinte. A função falha em uma sessão iniciada sem --access.config.


Exemplos​

Inspecionar a identidade estabelecida​

Juntas, as duas funções mostram o ID do principal do chamador e os seus grupos de diretório atuais. Como as associações são lidas novamente a cada instrução, executar esta instrução após uma alteração no diretório confirma que a alteração está visível para a sessão.

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