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

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.

Поддержка типов данных

PostgreSQLClickHouse
DATEDate
TIMESTAMPDateTime
REALFloat32
DOUBLEFloat64
DECIMAL, NUMERICDecimal
SMALLINTInt16
INTEGERInt32
BIGINTInt64
SERIALUInt32
BIGSERIALUInt64
TEXT, CHARString
INTEGERNullable(Int32)
ARRAYArray

Примеры использования

Создание базы данных в ClickHouse, обмен данными с сервером PostgreSQL:

Чтение данных из таблицы PostgreSQL:

Запись данных в таблицу PostgreSQL:

Предположим, что структура таблицы была изменена в PostgreSQL:

Поскольку параметр use_table_cache был установлен в 1 при создании базы данных, структура таблицы в ClickHouse была кэширована и, следовательно, не была изменена:

После отсоединения таблицы и повторного соединения, структура была обновлена: