PostgreSQL
Позволяет подключаться к базам данных на удалённом PostgreSQL сервере. Поддерживает операции чтения и записи (SELECT и INSERT запросы) для обмена данными между ClickHouse и PostgreSQL.
Обеспечивает доступ в реальном времени к списку таблиц и структуре таблиц с удалённого PostgreSQL с помощью запросов SHOW TABLES и DESCRIBE TABLE.
Поддерживает модификации структуры таблиц (ALTER TABLE ... ADD|DROP COLUMN). Если параметр use_table_cache (см. параметры движка ниже) установлен на 1, структура таблицы кэшируется и не проверяется на изменения, но может быть обновлена с помощью запросов DETACH и ATTACH.
Создание базы данных
Параметры движка
host:port— адрес сервера PostgreSQL.database— имя удалённой базы данных.user— пользователь PostgreSQL.password— пароль пользователя.schema— схема PostgreSQL.use_table_cache— определяет, кэшируется ли структура таблицы базы данных или нет. Необязательный. Значение по умолчанию:0.
Поддержка типов данных
| PostgreSQL | ClickHouse |
|---|---|
| DATE | Date |
| TIMESTAMP | DateTime |
| REAL | Float32 |
| DOUBLE | Float64 |
| DECIMAL, NUMERIC | Decimal |
| SMALLINT | Int16 |
| INTEGER | Int32 |
| BIGINT | Int64 |
| SERIAL | UInt32 |
| BIGSERIAL | UInt64 |
| TEXT, CHAR | String |
| INTEGER | Nullable(Int32) |
| ARRAY | Array |
Примеры использования
База данных в ClickHouse, обменивающаяся данными с сервером PostgreSQL:
Чтение данных из таблицы PostgreSQL:
Запись данных в таблицу PostgreSQL:
Рассмотрим, что структура таблицы была изменена в PostgreSQL:
Поскольку параметр use_table_cache был установлен на 1 при создании базы данных, структура таблицы в ClickHouse была закэширована и, следовательно, не была изменена:
После отсоединения таблицы и её повторного подключения структура была обновлена: