> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# настройки сервера user_*

> Настройки сервера ClickHouse в автоматически созданной группе user_*.

Эти настройки настраивают сервер ClickHouse и автоматически сгенерированы из исходного кода ClickHouse.

## user\_directories

Раздел файла конфигурации, содержащий следующие настройки:

* Путь к файлу конфигурации с предопределёнными пользователями.
* Путь к папке, в которой хранятся пользователи, созданные SQL-командами.
* Путь к узлу ZooKeeper, в котором хранятся и реплицируются пользователи, созданные SQL-командами.

Если этот раздел указан, пути из [users\_config](https://clickhouse.com/docs/ru/reference/settings/server-settings/settings/users.md#users_config) и [access\_control\_path](https://clickhouse.com/docs/ru/reference/settings/server-settings/settings/access-control.md#access_control_path) использоваться не будут.

Раздел `user_directories` может содержать любое количество элементов; их порядок определяет приоритет (чем выше элемент, тем выше приоритет).

**Примеры**

```xml theme={null}
<user_directories>
    <users_xml>
        <path>/etc/clickhouse-server/users.xml</path>
    </users_xml>
    <local_directory>
        <path>/var/lib/clickhouse/access/</path>
    </local_directory>
</user_directories>
```

Пользователи, роли, политики доступа к строкам, квоты и профили также могут храниться в ZooKeeper:

```xml theme={null}
<user_directories>
    <users_xml>
        <path>/etc/clickhouse-server/users.xml</path>
    </users_xml>
    <replicated>
        <zookeeper_path>/clickhouse/access/</zookeeper_path>
    </replicated>
</user_directories>
```

Вы также можете определить секции `memory` — это означает хранение информации только в памяти, без записи на диск, и `ldap` — это означает хранение информации на LDAP-сервере.

Чтобы добавить LDAP-сервер как удаленный каталог пользователей для пользователей, не определенных локально, определите единственную секцию `ldap` со следующими настройками:

| Настройка | Описание |
| - | - |
| `roles` | секция со списком локально определенных ролей, которые будут назначены каждому пользователю, полученному с LDAP-сервера. Если роли не указаны, пользователь не сможет выполнять никакие действия после аутентификации. Если какая-либо из перечисленных ролей не определена локально на момент аутентификации, попытка аутентификации завершится ошибкой, как если бы был указан неверный пароль. |
| `server` | одно из имен LDAP-серверов, определенных в секции `ldap_servers` config. Этот параметр обязателен и не может быть пустым. |

**Пример**

```xml theme={null}
<ldap>
    <server>my_ldap_server</server>
        <roles>
            <my_local_role1 />
            <my_local_role2 />
        </roles>
</ldap>
```

## user\_files\_path

Тип

String

По умолчанию

/var/lib/clickhouse/user\_files/

Изменяется без перезапуска

Нет

Каталог с пользовательскими файлами. Используется в табличных функциях [file()](https://clickhouse.com/docs/ru/reference/functions/table-functions/file.md), [fileCluster()](https://clickhouse.com/docs/ru/reference/functions/table-functions/fileCluster.md).

**Пример**

```xml theme={null}
<user_files_path>/var/lib/clickhouse/user_files/</user_files_path>
```

## user\_profile\_events\_per\_cpu

Тип Bool По умолчанию 1 Изменяется без перезапуска NoРаспределяет пользовательские счётчики `ProfileEvents` по CPU, чтобы избежать конфликтов за общие линии кэша между CPU при большом количестве потоков. Для каждого пользователя требуется `getNumCPUs() * num_events * sizeof(atomic)` памяти (сотни КиБ на машинах с большим числом ядер). Отключите этот параметр, чтобы вернуться к одному общему atomic на событие для каждого пользователя, пожертвовав пропускной способностью ради экономии памяти.

## user\_scripts\_path

Тип

String

По умолчанию

/var/lib/clickhouse/user\_scripts/

Изменяется без перезапуска

Нет

Каталог с файлами пользовательских скриптов. Используется для [исполняемых пользовательских функций](https://clickhouse.com/docs/ru/reference/functions/regular-functions/udf.md#executable-user-defined-functions).

**Пример**

```xml theme={null}
<user_scripts_path>/var/lib/clickhouse/user_scripts/</user_scripts_path>
```
