Подключение к ClickHouse Managed Postgres

Доступ к сведениям о подключении

Чтобы подключить приложения к ClickHouse Managed Postgres, перейдите в представление Connect на левой боковой панели вашего экземпляра.

Нажмите Connect на левой боковой панели, чтобы просмотреть сведения о подключении

При нажатии Connect открывается модальное окно, в котором отображаются ваши учетные данные и строки подключения в нескольких форматах.

Модальное окно подключения с учетными данными и форматами строк подключения

В модальном окне подключения отображается следующая информация:

Username: пользователь базы данных (по умолчанию: postgres)
Password: пароль базы данных (по умолчанию скрыт; нажмите значок глаза, чтобы показать его)
Server: имя хоста вашего экземпляра ClickHouse Managed Postgres
Port: порт PostgreSQL (по умолчанию: 5432)

ClickHouse Managed Postgres предоставляет superuser-доступ к вашей базе данных. Используйте эти учетные данные для подключения с правами superuser — это позволяет создавать дополнительных пользователей и управлять объектами базы данных.

Форматы строк подключения

На вкладках Connect via доступны строки подключения в нескольких форматах — под разные требования вашего приложения:

Format	Description
url	Стандартный URL подключения в формате `postgresql://<USER>:<PASSWORD>@<HOST>:<PORT>/<DATABASE>`
psql	Готовая команда для подключения через инструмент командной строки psql
env	Переменные окружения для клиентов на базе libpq
yaml	Конфигурация в формате YAML
jdbc	Строка подключения JDBC для Java-приложений

В целях безопасности пароль в строках подключения по умолчанию скрыт. Нажмите значок копирования рядом с любым полем или строкой подключения, чтобы сразу скопировать её в буфер обмена.

Пулинг соединений с PgBouncer

ClickHouse Managed Postgres включает встроенный экземпляр PgBouncer для пулинга соединений на стороне сервера. PgBouncer помогает улучшить управление соединениями, производительность и использование ресурсов, особенно для приложений, которые:

Открывают много одновременных соединений
Часто создают и закрывают соединения
Используют serverless- или временные вычислительные среды

Чтобы использовать пул соединений, включите переключатель via PgBouncer в верхней части модального окна подключения. Сведения о подключении обновятся, и ваши соединения будут направляться через пулер соединений, а не напрямую в PostgreSQL.

Настройка TLS

Все экземпляры ClickHouse Managed Postgres защищены с использованием TLS. Минимально поддерживаемая версия — TLS 1.3.

Быстрое подключение (с шифрованием TLS)

По умолчанию подключения используют шифрование TLS без проверки сертификата:

psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres'

Проверенное TLS‑соединение (рекомендуется для продакшна)

Для рабочих нагрузок в продакшне рекомендуем использовать проверенное TLS‑соединение, чтобы убедиться, что вы подключаетесь к нужному серверу. Для этого скачайте комплект CA‑сертификатов на вкладке Settings и добавьте его в список доверенных сертификатов клиента базы данных.

Скачайте CA‑сертификат на вкладке Settings

CA‑сертификат уникален для вашего экземпляра ClickHouse Managed Postgres и не будет работать с другими экземплярами.

Чтобы установить проверенное TLS‑соединение, добавьте sslmode=verify-full и путь к скачанному сертификату:

psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'