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

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

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

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

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

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

   Будет выведен список пользователей на каждом узле. Если списки пользователей на каждом узле одинаковые, значит пользователи синхронизированы.

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   SELECT *
   2
   FROM clusterAllReplicas('{cluster}', system.users)
   3
   WHERE name = '<имя пользователя>'
   4
   LIMIT 1;

   Здесь условие LIMIT со значением 1 возвращает первую найденную запись из таблицы system.users.

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

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

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

   1
   CREATE USER [IF NOT EXISTS] <имя пользователя>
   2
   ON CLUSTER '<имя кластера>'
   3
   IDENTIFIED BY '<пароль>';

   Условия в запросе:

   • IF NOT EXISTS — предотвращает ошибку, если пользователь с таким именем уже существует.
   • ON CLUSTER — создает пользователя на всех узлах заданного кластера.
   • IDENTIFIED — задает, как пользователь будет проходить аутентификацию.

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.roles);

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

   1
   GRANT <имя роли> TO <имя пользователя> ON CLUSTER '<имя кластера>';

   Пользователь получит все привилегии, выданные роли. Изменения применятся на всех узлах.

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

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

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

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

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

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.roles);

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

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

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.settings_profiles);

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

   1
   ALTER USER <имя пользователя>
   2
   ON CLUSTER '<имя кластера>'
   3
   SETTINGS PROFILE = '<имя профиля>';

   Пользователь будет использовать указанный профиль во всех новых сессиях. Изменения применятся на всех узлах.

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

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

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

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   ALTER USER <имя пользователя>
   2
   ON CLUSTER '<имя кластера>'
   3
   SETTINGS PROFILE = NONE;

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

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

2. Узнайте имя пользователя:

   1
   SELECT hostName(), name
   2
   FROM clusterAllReplicas('{cluster}', system.users);

   Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

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

   1
   DROP USER [IF EXISTS] <имя пользователя> ON CLUSTER '<имя кластера>' SYNC;

   Условия в запросе:

   • IF EXISTS — предотвращает ошибку, если пользователя с таким именем не существует.
   • ON CLUSTER — удаляет пользователя на всех узлах заданного кластера.
   • SYNC — гарантирует, что команда завершится только после применения изменений на всех узлах.