> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Бета</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Возможность в статусе бета. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Подробнее.
                    </a>
                </u>
            </span>
        </div>;
};

<Tip>
  **SQL Console**

  На этой странице описано, как подключить ваши продакшн-системы к Postgres. Если вам нужно быстро выполнить запрос, вы можете подключиться через [SQL Console](/ru/integrations/connectors/sql-clients/sql-console), как и в случае с экземплярами ClickHouse.
</Tip>

<div id="accessing-connection-details">
  ## Доступ к сведениям о подключении
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CAgHfVRSetEkx9fz/images/managed-postgres/connect-button.png?fit=max&auto=format&n=CAgHfVRSetEkx9fz&q=85&s=d2b0a4e4f0b272f45f8f912663dc904d" alt="Нажмите Connect на левой боковой панели, чтобы просмотреть сведения о подключении" size="md" border width="1378" height="1148" data-path="images/managed-postgres/connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CAgHfVRSetEkx9fz/images/managed-postgres/connect-modal.png?fit=max&auto=format&n=CAgHfVRSetEkx9fz&q=85&s=def2517a721dfdbd149492875ad41b36" alt="Модальное окно подключения с учетными данными и форматами строк подключения" size="md" border width="1910" height="1728" data-path="images/managed-postgres/connect-modal.png" />

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

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

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

<div id="connection-string">
  ## Форматы строк подключения
</div>

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

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

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

<div id="pgbouncer">
  ## Пулинг соединений с PgBouncer
</div>

Managed Postgres включает встроенный экземпляр [PgBouncer](https://www.pgbouncer.org/) для пулинга соединений на стороне сервера. PgBouncer помогает улучшить управление соединениями, производительность и использование ресурсов, особенно для приложений, которые:

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

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

<Tip>
  **Когда использовать PgBouncer**

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

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

<div id="tls">
  ## Настройка TLS
</div>

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

<div id="quick-connection">
  ### Быстрое подключение (с шифрованием TLS)
</div>

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

```bash theme={null}
psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres'
```

<div id="verified-tls">
  ### Проверенное TLS‑соединение (рекомендуется для продакшна)
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CAgHfVRSetEkx9fz/images/managed-postgres/tls-ca-bundle.png?fit=max&auto=format&n=CAgHfVRSetEkx9fz&q=85&s=b6998aff9410012ede79ebf2152b5e02" alt="Скачайте CA‑сертификат на вкладке Settings" size="md" border width="3244" height="2028" data-path="images/managed-postgres/tls-ca-bundle.png" />

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

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

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