Источники словарей

Синтаксис

Совет

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

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

DDL

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

Configuration file

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

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

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

• Локальный файл
• Исполняемый файл
• Пул исполняемых файлов
• 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'))
--highlight-next-line
SETTINGS(format_csv_allow_single_quotes = 0)

Configuration file

<source>
  <file>
    <path>/opt/dictionaries/os.tsv</path>
    <format>TabSeparated</format>
  </file>
  <settings>
#highlight-next-line
      <format_csv_allow_single_quotes>0</format_csv_allow_single_quotes>
  </settings>
</source>