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

Managed PostgreSQL

Управляемый PostgreSQL — отдельный кластер со строкой подключения для psql, приложений и ORM. Это другой продукт, чем Supabase, который предоставляет готовый backend с REST API и авторизацией.

Создание кластера​

В панели управления выберите проект и раздел Managed PostgreSQL. Для работы из терминала сначала подключите CLI.

Посмотрите доступные регионы, версии и идентификаторы тарифов:

tatnet pg regions -o json

Создайте кластер в выбранном проекте и приватной сети:

tatnet pg create -p <проект> \
--name <имя> --region <регион> --plan <тариф> \
--topology single --vpc <id-сети> --allow <CIDR-клиента>

Значения в угловых скобках замените своими. CIDR должен соответствовать адресам клиентов, которым нужен доступ. Справочник опций: tatnet pg create --help.

Подключение​

Дождитесь готовности кластера и возьмите адрес подключения из панели или ответа CLI:

tatnet pg get <кластер> -o json

Приложение и кластер можно подключить к одной VPC. Список разрешённых адресов задаётся отдельно от привязки к сети. Для TLS-подключения сохраните CA кластера:

tatnet pg ca <кластер> --out cluster-ca.pem

В psql и PostgreSQL-драйвере используйте sslmode=verify-full и путь к CA в sslrootcert. Пароль храните в секретных переменных приложения.

Управление​

  • tatnet pg list — кластеры аккаунта; -p <проект> ограничивает список.
  • tatnet pg allowlist --help — изменение разрешённых адресов.
  • tatnet pg plan --help — смена тарифа.
  • tatnet pg topology --help — смена топологии.
  • tatnet pg reset-password --help — смена пароля.

Резервные копии доступны через tatnet pg backup list <кластер> и tatnet pg backup create <кластер> <метка>. Параметры сервера — через tatnet pg parameters --help.

Стоимость​

Тариф относится к одному узлу. Итог зависит от числа узлов выбранной топологии; публичные IP оплачиваются отдельно. Актуальные суммы — на странице цен и в публичном прайс-листе.

Несколько баз и пользователи​

Стартовый пользователь — администратор клиентских баз, без PostgreSQL SUPERUSER и доступа к служебной роли репликации. Он может создавать дополнительные базы:

CREATE DATABASE analytics;

На PostgreSQL 16 и новее пользователь создаётся обычным SQL:

CREATE ROLE reporting LOGIN PASSWORD '<случайный-пароль-не-короче-16-символов>';

На PostgreSQL 15 подключитесь к стартовой базе и используйте ограниченную функцию:

SELECT _tatnet_admin.create_user('reporting', '<случайный-пароль-не-короче-16-символов>');
-- Смена его пароля на PostgreSQL 15:
SELECT _tatnet_admin.set_password('reporting', '<новый-случайный-пароль>');

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

GRANT CONNECT ON DATABASE app TO reporting;
GRANT USAGE ON SCHEMA public TO reporting;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO reporting;
ALTER DEFAULT PRIVILEGES FOR ROLE app IN SCHEMA public
GRANT SELECT ON TABLES TO reporting;

Повторите выдачу прав для других нужных схем и ролей, создающих таблицы. Не выдавайте читающему пользователю членство в роли владельца базы. Пользователь остаётся без прав записи и при подключении к основному узлу. Созданные через SQL базы и роли реплицируются; список стартовых реквизитов в панели не является полным каталогом объектов PostgreSQL.

Реплики для чтения​

Выделенные read replicas настраиваются отдельно от HA. Они получают изменения через физическую асинхронную репликацию и автоматически основными узлами не становятся. Возможна задержка: чтение сразу после записи может вернуть старые данные. Все базы одного PostgreSQL-кластера копируются вместе.

tatnet pg read-replicas <кластер> --count 1
tatnet pg get <кластер> -o json

Дождитесь read_replicas_pending=false, проверьте состояние узлов и лаг. Используйте возвращённые read_host и read_port с теми же CA и TLS-настройками. Адрес совпадает с основным адресом кластера, порт чтения — 5433; запись — 5432. Reader endpoint не переключается на primary или HA standby при отсутствии готовых реплик. Приложение должно повторять соединение после временного отказа.

Каждая из максимум пяти реплик оплачивается по тарифу узла кластера. Дополнительный публичный IP не требуется. HA standby служит отказоустойчивости и не входит в список выделенных читающих реплик.

# Удалить выделенные реплики; основная база сохраняется:
tatnet pg read-replicas <кластер> --count 0

В API: PUT /v1/projects/{project_id}/pg-clusters/{cluster_id}/read-replicas с телом {"read_replica_count":1}. Для создания вместе с новым кластером это же поле доступно в запросе создания. В MCP — set_postgres_read_replicas. Операция требует права изменения PostgreSQL-кластера и записывает намерение; фактическую готовность проверяют по ответу API. Настройки версий возвращаются в version_capabilities; PostgreSQL 15 использует ограниченные функции управления пользователями, PostgreSQL 16+ — штатный CREATEROLE.

Отказоустойчивость и обновление узлов​

В топологии single работает один узел. HA — пара узлов под управлением Patroni: основной принимает запись, резервный обеспечивает автоматическое переключение при отказе. Выделенные реплики для чтения настраиваются отдельно и не заменяют HA.

Выберите топологию при создании или измените её в карточке кластера. Переход single ↔ HA и смена тарифа доступны без создания новой базы. Каждый узел оплачивается отдельно.

Когда доступен новый образ, карточка сообщает, что образ узлов устарел. Запустите обновление из карточки: платформа заменяет узлы по одному, начиная с реплик. Для HA это позволяет обновлять узлы без остановки сервиса. Приложение должно уметь переподключаться после переключения основного узла; для single резервного узла нет.

Восстановление на момент времени (PITR)​

PITR восстанавливает данные в новый кластер, не перезаписывая исходный.

  1. Откройте резервные копии в карточке PostgreSQL-кластера.
  2. Выберите восстановление на момент времени и доступную точку.
  3. Создайте новый кластер и дождитесь его готовности.
  4. Проверьте таблицы и данные, настройте VPC и разрешённые адреса для клиентов.
  5. Обновите строку подключения приложения и проверьте чтение и запись.

Выбирайте момент в доступном для конкретного кластера окне восстановления. Не считайте наличие бэкапа проверкой восстановления: периодически проверяйте данные в восстановленном кластере. Резервные копии не заменяют HA, а HA не защищает от ошибочного удаления данных.

Обзор продукта — Managed PostgreSQL на tatnet.ru.