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

Синтаксис

Если вы используете словарь в ClickHouse Cloud, для создания словарей используйте вариант с DDL-запросом, а сам словарь создавайте от имени пользователя default. Также проверьте список поддерживаемых источников для словарей в руководстве по совместимости с Cloud.

Словарь можно подключить к ClickHouse из самых разных источников. Источник задаётся в разделе source файла конфигурации и с помощью предложения SOURCE в DDL-операторе.

DDL
файл конфигурации

CREATE DICTIONARY dict_name (...)
...
SOURCE(SOURCE_TYPE(param1 val1 ... paramN valN)) -- Конфигурация источника
...

<clickhouse>
  <dictionary>
    ...
    <source>
      <source_type>
        <!-- Конфигурация источника -->
      </source_type>
    </source>
    ...
  </dictionary>
  ...
</clickhouse>

Поддерживаемые источники словаря

Доступны следующие типы источников (SOURCE_TYPE/source_type):

Локальный файл
Исполняемый файл
Executable Pool
HTTP(S)
СУБД
- ODBC
- MySQL
- ClickHouse
- MongoDB
- Redis
- Cassandra
- PostgreSQL
- YTsaurus
YAMLRegExpTree
Null

Для типов источников Локальный файл, Исполняемый файл, HTTP(s), ClickHouse можно использовать дополнительные настройки:

DDL
Файл конфигурации

SOURCE(FILE(path './user_files/os.tsv' format 'TabSeparated'))
SETTINGS(format_csv_allow_single_quotes = 0)

<source>
  <file>
    <path>/opt/dictionaries/os.tsv</path>
    <format>TabSeparated</format>
  </file>
  <settings>
      <format_csv_allow_single_quotes>0</format_csv_allow_single_quotes>
  </settings>
</source>

Последнее изменение 3 июля 2026 г.

Local FileНастройте локальный файл как источник словаря в ClickHouse.

​Синтаксис

​Поддерживаемые источники словаря

Синтаксис

Поддерживаемые источники словаря