Управление пользователем

В Managed ClickHouse управлять пользователями можно с помощью SQL-запросов. С полным списком SQL-операторов ClickHouse вы можете ознакомиться в официальной документации ClickHouse.

Получить список пользователей в кластере

Запросите список пользователей из системной таблицы system.users, которая содержит метаданные обо всех пользователях. Для этого используйте оператор SELECT и виртуальный движок clusterAllReplicas, который выполняет запрос к указанной таблице на всех узлах всех шардов заданного кластера.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Выполните запрос:

1
SELECT name
2
FROM system.users
3
ORDER BY name;

Получить информацию о конкретном пользователе

Запросите данные о пользователе из системной таблицы system.users по его имени. Для просмотра используйте оператор SELECT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```
Выполните запрос:
sql
```
1
SELECT *
2
FROM system.users
3
WHERE name = '<имя пользователя>'
4
LIMIT 1;
```
Здесь условие LIMIT со значением 1 возвращает первую найденную запись из таблицы system.users.

Создать пользователя

Для создания пользователя используйте оператор CREATE.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Выполните запрос:
sql
```
1
CREATE USER [IF NOT EXISTS] <имя пользователя>
2
IDENTIFIED BY '<пароль>';
```
Условия в запросе:
- IF NOT EXISTS — предотвращает ошибку, если пользователь с таким именем уже существует.
- IDENTIFIED — задает, как пользователь будет проходить аутентификацию.

Назначить роль пользователю

Для операции используйте оператор GRANT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Узнайте имя роли:

1
SELECT name
2
FROM system.roles
3
ORDER BY name;

Выполните запрос:
sql
```
1
GRANT <имя роли> TO <имя пользователя>;
```
Пользователь получит все привилегии, выданные роли.

Выдать привилегию пользователю

Для операции используйте оператор GRANT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Выполните запрос:

1
GRANT <привилегия> TO <имя пользователя>;

Получить роли пользователя

Запросите список назначенных пользователю ролей из системной таблицы system.users по имени пользователя. Для просмотра используйте оператор SELECT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Выполните запрос:

1
SELECT granted_roles
2
FROM system.users
3
WHERE name = '<имя пользователя>';

Отозвать роль или привилегию у пользователя

Для операции используйте оператор REVOKE.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Узнайте имя роли:

1
SELECT name
2
FROM system.roles
3
ORDER BY name;

Выполните запрос:

1
REVOKE <имя роли или привилегия> FROM <имя пользователя>;

Назначить профиль настроек пользователю

Для операции используйте оператор ALTER USER.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Узнайте имя профиля:

1
SELECT name
2
FROM system.settings_profiles
3
ORDER BY name;

Выполните запрос:
sql
```
1
ALTER USER <имя пользователя>
2
SETTINGS PROFILE = '<имя профиля>';
```
Пользователь будет использовать указанный профиль во всех новых сессиях.

Также вы можете назначить пользователю профиль настроек при создании профиля.

Получить профиль настроек пользователя

Запросите информацию о профиле, назначенном пользователю, из системной таблицы system.users. Для просмотра используйте оператор SELECT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Выполните запрос:

1
SELECT name, settings_profile
2
FROM system.users
3
WHERE name = '<имя пользователя>';

В поле settings_profile будет указано имя профиля, назначенного пользователю. Если профиль не назначен, поле будет пустым.

Отозвать профиль настроек у пользователя

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```

Выполните запрос:

1
ALTER USER <имя пользователя>
2
SETTINGS PROFILE = NONE;

Удалить пользователя

Для удаления пользователя используйте оператор DROP.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.
Узнайте имя пользователя:
sql
```
1
SELECT name
2
FROM system.users
3
ORDER BY name;
```
Выполните запрос:
sql
```
1
DROP USER [IF EXISTS] <имя пользователя>;
```
В запросе условие IF EXISTS предотвращает ошибку, если пользователя с таким именем не существует.