Перейти к основному содержимому
Перейти к основному содержимому

ExternalDistributed

Движок ExternalDistributed позволяет выполнять запросы SELECT к данным, которые хранятся на удалённых серверах MySQL или PostgreSQL. Принимает в качестве аргумента движки MySQL или PostgreSQL, поэтому возможна шардинг.

Создание таблицы​

CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1] [TTL expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2] [TTL expr2],
    ...
) ENGINE = ExternalDistributed('engine', 'host:port', 'database', 'table', 'user', 'password');

Смотрите подробное описание запроса CREATE TABLE.

Структура таблицы может отличаться от исходной структуры таблицы:

  • Имена колонок должны совпадать с именами в исходной таблице, но вы можете использовать только некоторые из этих колонок и в любом порядке.
  • Типы колонок могут отличаться от тех, что в исходной таблице. ClickHouse пытается привести значения к типам данных ClickHouse.

Параметры движка

  • engine — Движок таблицы MySQL или PostgreSQL.
  • host:port — Адрес сервера MySQL или PostgreSQL.
  • database — Имя удалённой базы данных.
  • table — Имя удалённой таблицы.
  • user — Имя пользователя.
  • password — Пароль пользователя.

Подробности реализации​

Поддерживает несколько реплик, которые должны быть перечислены через |, а шардов — через ,. Например:

CREATE TABLE test_shards (id UInt32, name String, age UInt32, money UInt32) ENGINE = ExternalDistributed('MySQL', `mysql{1|2}:3306,mysql{3|4}:3306`, 'clickhouse', 'test_replicas', 'root', 'clickhouse');

При указании реплик одна из доступных реплик выбирается для каждого шардирования при чтении. Если соединение не удаётся, выбирается следующая реплика, и так далее для всех реплик. Если попытка соединения не удаётся для всех реплик, попытка повторяется тем же образом несколько раз.

Вы можете указать любое количество шардов и любое количество реплик для каждого шарда.

Смотрите также