←К документации

Connection strings

Stable

Формат DSN, шаблон и правила хранения секретов.

Обновлено: 4 февраля 2026 г.

Единый формат DSN для клиентов PostgreSQL.

DSN (пример)

postgres://<pg_user>:<pg_password>@<gateway-host>:5432/<db-name>?sslmode=require
  • <gateway-host> — внешний PostgreSQL endpoint платформы (Gateway).
  • <pg_user> / <pg_password> — креды tenant’а (одни и те же для всех БД внутри tenant).
  • <db-name> — имя БД внутри tenant.
  • sslmode=require — обязательный параметр (Gateway принимает только TLS).

Где взять DSN

  • При create tenant CP возвращает pg_user, pg_password и dsn_template.
  • Также можно получить их повторно через GET /v2/tenants/<tenant>/credentials (при наличии прав).

dsn_template выглядит так:

postgres://<pg_user>:<pg_password>@<gateway-host>:5432/<db-name>?sslmode=require

Замените <db-name> на имя вашей базы.

Важно про секреты

  • API key ≠ DSN. API key используется только для вызовов CP (Console/CLI/API).
  • В DSN должны быть только pg_user/pg_password. Не встраивайте API key в строки подключения приложения.
  • Храните pg_password в Secret Manager/CI secrets и ротуйте его по процедуре (см. раздел Security).