---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/yql/reference/syntax/create-group.md?version=main
  - https://ydb.tech/docs/ru/yql/reference/syntax/create-group.md?version=main
sourcePath: ru/core/yql/reference/syntax/create-group.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# CREATE GROUP

Команда `CREATE GROUP` создаёт [группу](https://ydb.tech/docs/ru/concepts/glossary.md?version=main#access-group) с указанным именем. Есть возможность указать список [пользователей](https://ydb.tech/docs/ru/concepts/glossary.md?version=main#access-user), входящих в эту группу.

Синтаксис:

```yql
CREATE GROUP group_name [ WITH USER user_name [ , user_name [ ... ]] [ , ] ]
```

* `group_name` — имя группы. Может содержать только строчные буквы латинского алфавита (a–z), цифры (0–9). Имя не должно быть пустым.
* `user_name` — имя пользователя, который станет участником группы после её создания. Может содержать строчные буквы латинского алфавита и цифры.

## Примеры

### Успешно выполненные команды

Создание группы:

```yql
CREATE GROUP group1;
```

```yql
CREATE GROUP group2 WITH USER root;
```

```yql
CREATE GROUP group3 WITH USER root, root1;
```

```yql
CREATE GROUP group4 WITH USER root, root1, root2;
```

### Обработка ошибок

Корректно обработанные ошибки:

| Ситуация | Сообщение об ошибке |
|----------|---------------------|
| Повторное создание группы | Group already exists |
| Невалидное имя (например, `group1№`) | token recognition error at: '№' |

## Встроенные группы

<!-- source: ru/yql/reference/_includes/initial_groups_and_users.md -->
YDB может иметь набор групп и пользователей уже с момента начального развёртывания.

Подробнее см. [Первичные настройки безопасности](https://ydb.tech/docs/ru/reference/configuration/security_config.md?version=main#security-bootstrap) и [Начальная настройка безопасности кластера](https://ydb.tech/docs/ru/security/builtin-security.md?version=main).

Такие пользователи и группы ничем не отличаются от пользователей и групп, созданных позже.
<!-- endsource: ru/yql/reference/_includes/initial_groups_and_users.md -->

## См. также

* [ALTER GROUP](https://ydb.tech/docs/ru/yql/reference/syntax/alter-group.md?version=main)
* [DROP GROUP](https://ydb.tech/docs/ru/yql/reference/syntax/drop-group.md?version=main)