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

Строки подключения, пул соединений PgBouncer и настройка TLS для ClickHouse Managed Postgres

​

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

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

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

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

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

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

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

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

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

Когда использовать PgBouncer

Используйте PgBouncer, если ваше приложение открывает много краткоживущих соединений. Для долгоживущих соединений или приложений, использующих возможности PostgreSQL, несовместимые с пулом соединений (например, подготовленные операторы между транзакциями), подключайтесь напрямую.

Передача данных в ClickHouse с помощью ClickPipes через PgBouncer не поддерживается.

​

Настройка TLS

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

​

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

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

psql 'postgresql://postgres:[e-mail]:5432/postgres'

​

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

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

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

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

psql 'postgresql://postgres:[e-mail]:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'