> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Источник словаря ClickHouse

> Настройка таблицы ClickHouse в качестве источника словаря.

Пример настроек:

<Tabs>
  <Tab title="DDL">
    ```sql theme={null}
    SOURCE(CLICKHOUSE(
        host 'example01-01-1'
        port 9000
        user 'default'
        password ''
        db 'default'
        table 'ids'
        where 'id=10'
        secure 1
        query 'SELECT id, value_1, value_2 FROM default.ids'
    ));
    ```
  </Tab>

  <Tab title="Файл конфигурации">
    ```xml theme={null}
    <source>
        <clickhouse>
            <host>example01-01-1</host>
            <port>9000</port>
            <user>default</user>
            <password></password>
            <db>default</db>
            <table>ids</table>
            <where>id=10</where>
            <secure>1</secure>
            <query>SELECT id, value_1, value_2 FROM default.ids</query>
        </clickhouse>
    </source>
    ```
  </Tab>
</Tabs>

<br />

Поля настроек:

| Настройка | Описание |
| - | - |
| `host` | Хост ClickHouse. Если это локальный хост, запрос обрабатывается без какой-либо сетевой активности. Для повышения отказоустойчивости можно создать таблицу [Distributed](/ru/reference/engines/table-engines/special/distributed) и указать ее в последующих конфигурациях. |
| `port` | Порт сервера ClickHouse. |
| `user` | Имя пользователя ClickHouse. |
| `password` | Пароль пользователя ClickHouse. |
| `db` | Имя базы данных. |
| `table` | Имя таблицы. |
| `where` | Условие выборки. Необязательно. |
| `invalidate_query` | Запрос для проверки состояния словаря. Необязательно. Подробнее см. в разделе [Обновление данных словаря с помощью LIFETIME](/ru/reference/statements/create/dictionary/lifetime). |
| `secure` | Использовать SSL для соединения. |
| `query` | Пользовательский запрос. Необязательно. |

<Note>
  Поля `table` и `where` нельзя использовать вместе с полем `query`. При этом должно быть указано одно из полей: `table` или `query`.
</Note>