Подключение ClickHouse к PostgreSQL
Эта страница охватывает следующие варианты интеграции PostgreSQL с ClickHouse:
- с использованием ClickPipes, управляемой службы интеграции для ClickHouse Cloud, основанной на PeerDB - сейчас в публичном бета-тестировании!
- с использованием PeerDB, инструмента CDC с открытым исходным кодом, специально разработанного для репликации баз данных PostgreSQL как для самоуправляемого ClickHouse, так и для ClickHouse Cloud.
- с использованием движка таблиц
PostgreSQL
для чтения из таблицы PostgreSQL - с использованием экспериментального движка базы данных
MaterializedPostgreSQL
для синхронизации базы данных в PostgreSQL с базой данных в ClickHouse
Использование движка таблиц PostgreSQL
Движок таблиц PostgreSQL
позволяет выполнять операции SELECT и INSERT с данными, хранящимися на удалённом сервере PostgreSQL из ClickHouse. Эта статья иллюстрирует основные методы интеграции, используя одну таблицу.
1. Настройка PostgreSQL
- В
postgresql.conf
добавьте следующую запись, чтобы включить прослушивание PostgreSQL на сетевых интерфейсах:
- Создайте пользователя для подключения из ClickHouse. Для демонстрационных целей в этом примере предоставляются полные права суперпользователя.
- Создайте новую базу данных в PostgreSQL:
- Создайте новую таблицу:
- Давайте добавим несколько строк для тестирования:
- Чтобы настроить PostgreSQL для разрешения подключений к новой базе данных с новым пользователем для репликации, добавьте следующую запись в файл
pg_hba.conf
. Обновите строку адреса с помощью подсети или IP-адреса вашего сервера PostgreSQL:
- Перезагрузите конфигурацию
pg_hba.conf
(откорректируйте эту команду в зависимости от вашей версии):
- Убедитесь, что новый
clickhouse_user
может войти:
Если вы используете эту функцию в ClickHouse Cloud, вам может понадобиться разрешить IP-адресам ClickHouse Cloud доступ к вашему экземпляру PostgreSQL. Проверьте API конечных точек Cloud для получения информации о выходном трафике.
2. Определение таблицы в ClickHouse
- Войдите в
clickhouse-client
:
- Давайте создадим новую базу данных:
- Создайте таблицу, использующую
PostgreSQL
:
Минимальные параметры, необходимые для подключения:
parameter | Описание | пример |
---|---|---|
host:port | имя хоста или IP и порт | postgres-host.domain.com:5432 |
database | имя базы данных PostgreSQL | db_in_psg |
user | имя пользователя для подключения к postgres | clickhouse_user |
password | пароль для подключения к postgres | ClickHouse_123 |
Просмотрите документацию по движку таблиц PostgreSQL для получения полного списка параметров.
3. Тестирование интеграции
- В ClickHouse просмотрите начальные строки:
Таблица ClickHouse должна автоматически заполняться двумя строками, которые уже существовали в таблице PostgreSQL:
- Вернитесь в PostgreSQL и добавьте несколько строк в таблицу:
- Эти две новые строки должны появиться в вашей таблице ClickHouse:
Ответ должен быть:
- Давайте посмотрим, что произойдет, когда вы добавите строки в таблицу ClickHouse:
- Строки, добавленные в ClickHouse, должны появиться в таблице PostgreSQL:
Этот пример продемонстрировал базовую интеграцию между PostgreSQL и ClickHouse, используя движок таблиц PostgreSQL
. Ознакомьтесь с документацией по движку таблиц PostgreSQL для получения дополнительной информации о функциях, таких как указание схем, возврат только подмножества столбцов и подключение к нескольким репликам. Также проверьте ClickHouse и PostgreSQL - пара, созданная в данных - часть 1 в блоге.
Использование движка базы данных MaterializedPostgreSQL
Движок базы данных PostgreSQL использует функции репликации PostgreSQL для создания реплики базы данных со всеми или частью схем и таблиц. Эта статья иллюстрирует основные методы интеграции, используя одну базу данных, одну схему и одну таблицу.
В следующих процедурах используются CLI PostgreSQL (psql) и CLI ClickHouse (clickhouse-client). Сервер PostgreSQL установлен на Linux. Следующие настройки минимальны, если база данных PostgreSQL является новой тестовой установкой
1. В PostgreSQL
- В
postgresql.conf
установите минимальные уровни прослушивания, уровень репликации WAL и слоты репликации:
добавьте следующие записи:
*ClickHouse требует минимум уровень WAL logical
и минимум 2
слота репликации
- Используя учетную запись администратора, создайте пользователя для подключения из ClickHouse:
*для демонстрационных целей предоставлены полные права суперпользователя.
- создайте новую базу данных:
- подключитесь к новой базе данных в
psql
:
- создайте новую таблицу:
- добавьте начальные строки:
- Настройте PostgreSQL для разрешения подключений к новой базе данных с новым пользователем для репликации. Ниже приведена минимальная запись, которую необходимо добавить в файл
pg_hba.conf
:
*для демонстрационных целей используется метод аутентификации с открытым текстом пароля. обновите строку адреса в соответствии с документацией PostgreSQL
- перезагрузите конфигурацию
pg_hba.conf
с помощью команды вроде этой (откорректируйте в соответствии с вашей версией):
- Проверьте вход с новым
clickhouse_user
:
2. В ClickHouse
- войдите в CLI ClickHouse
- Включите экспериментальную функцию PostgreSQL для движка базы данных:
- Создайте новую базу данных, которая будет реплицироваться, и определите начальную таблицу:
минимальные опции:
parameter | Описание | пример |
---|---|---|
host:port | имя хоста или IP и порт | postgres-host.domain.com:5432 |
database | имя базы данных PostgreSQL | db1 |
user | имя пользователя для подключения к postgres | clickhouse_user |
password | пароль для подключения к postgres | ClickHouse_123 |
settings | дополнительные настройки для движка | materialized_postgresql_tables_list = 'table1' |
Для полного руководства по движку базы данных PostgreSQL смотрите https://clickhouse.com/docs/engines/database-engines/materialized-postgresql/#settings
- Проверьте, есть ли данные в начальной таблице:
3. Тестирование базовой репликации
- В PostgreSQL добавьте новые строки:
- В ClickHouse проверьте, видны ли новые строки:
4. Резюме
Этот руководство по интеграции сосредоточено на простом примере, как реплицировать базу данных с таблицей, однако существуют более продвинутые опции, включая репликацию целой базы данных или добавление новых таблиц и схем в существующие репликации. Хотя DDL команды не поддерживаются для этой репликации, движок может быть настроен для обнаружения изменений и перезагрузки таблиц при внесении структурных изменений.
Для получения дополнительных функций, доступных для продвинутых опций, пожалуйста, смотрите справочную документацию.