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

Типы источников словаря

​

Синтаксис

Если вы используете словарь в 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>