# WHOAMI

> Функція WHOAMI у StackQL: повертає ідентифікатор principal автентифікованої сторони, що викликає, коли ввімкнено керування доступом.

Source: https://stackql.io/uk/language-spec/functions/session/whoami

Повертає ідентифікатор principal автентифікованої сторони, що викликає.  Потрібен сеанс, у якому ввімкнено [керування доступом](/command-line-usage/access-management).  Доступно в StackQL `v1.0` і новіших версіях.

Див. також:  
[[` GROUPS `]](/language-spec/functions/session/groups) [[ Керування доступом ]](/command-line-usage/access-management)

* * * 

## Синтаксис

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

## Аргументи

Немає.

## Значення, що повертається

Повертає рядкове значення ідентифікатора principal, встановленого для поточної інструкції.  У сеансі, запущеному без `--access.config`, функція завершується помилкою.

* * *

## Приклади

### Перевірка встановленої ідентичності

Обидві функції не приймають аргументів і описують сторону, що викликає, яку сервер автентифікував для цієї інструкції.  `whoami()` повертає ідентифікатор principal, а `groups()` - групи каталогу сторони, що викликає, тому їх спільне виконання дає змогу швидко перевірити, що токен або сертифікат відповідає очікуваному principal, перш ніж виконувати щось інше.

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