Данные
Базы данных
PostgreSQL, Redis, MongoDB и MySQL — в один клик, переменные подключения автоматически передаются сервисам.
База данных работает в отдельном контейнере внутри окружения проекта. После добавления её адрес записывается переменной во все сервисы окружения — в том числе в сервисы, добавленные позже.
Поддерживаемые базы данных
| База | Версия | Основная переменная | Дополнительные переменные |
|---|---|---|---|
| PostgreSQL | 15, 16, 17 | DATABASE_URL |
PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE, POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB |
| Redis | 7 | REDIS_URL |
REDISHOST, REDISPORT, REDISPASSWORD |
| MongoDB | 7, 8.0 | MONGO_URL |
MONGODB_URI, MONGO_URI, MONGODB_URL, MONGOHOST, MONGOPORT, MONGOUSER, MONGOPASSWORD |
| MySQL | 8.0, 8.4 | MYSQL_URL |
MYSQLHOST, MYSQLPORT, MYSQLUSER, MYSQLPASSWORD, MYSQLDATABASE, MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE |
Жирным отмечена версия по умолчанию. Версию выбирают при добавлении базы, и потом её не изменить — чтобы перейти на новую, добавьте базу нужной версии и перенесите данные (pg_dump/mysqldump/mongodump через SSH-туннель).
Например, для PostgreSQL:
DATABASE_URL=postgresql://app:<пароль>@postgres:5432/app
В коде просто читайте переменную:
import pg from 'pg'
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL })
Где бот или приложение с SQLite хранит свой файл — Хранение файлов и данных.
Подключение
- База видна только изнутри проекта: хост — внутреннее имя (
postgres,redis…). Публичного порта нет — с вашего компьютера только через SSH-туннель (ниже). - Таблицы можно просматривать на странице базы в кабинете.
- У каждого окружения свои базы: при создании
stagingдля каждого типа базы изproductionсоздаётся пустая копия — данные не переносятся.
Подключение через DBeaver/TablePlus по SSH
Публичного порта у базы нет. Ваш компьютер подключается через SSH-туннель, подписанный вашим ключом, — у SSH нет ни пароля, ни shell.
- Если ключа нет, создайте:
ssh-keygen -t ed25519, затем добавьте содержимое~/.ssh/id_ed25519.pubв кабинете: Аккаунт → SSH-ключи. Принимаются только ключи ed25519 или RSA не короче 3072 бит. - Откройте страницу базы → Подключение с вашего компьютера. Выберите клиент (DBeaver / DataGrip, TablePlus, pgAdmin, MongoDB Compass или Терминал).
- Скопируйте поля SSH (хост, порт, пользователь = slug базы (её короткое имя в адресе), аутентификация = public key, ключ
~/.ssh/id_ed25519) и поля базы (хост = движок, напримерpostgres; порт; база; пользователь; пароль) в соответствующие вкладки клиента. - Терминал: запустите показанную команду
ssh -N -L ..., не закрывайте её и подключайтесь кlocalhostпо показанному адресу.
Пароль видит только владелец проекта.
Типы: pgvector, PostGIS, кэш Redis
При добавлении PostgreSQL или Redis выбирается и тип. Как и версия, после создания он не меняется.
| Тип | Что это |
|---|---|
| PostgreSQL — Обычная | Официальный образ. Расширения из списка ниже. |
| PostgreSQL — с pgvector | Добавляет расширение vector: AI-эмбеддинги и поиск по сходству. |
| PostgreSQL — с PostGIS | Добавляет postgis и postgis_topology: карты, координаты, геометрия. |
| Redis — С сохранением (по умолчанию) | Каждая запись сохраняется на диск (AOF). Когда память заполнена, новые ключи не принимаются, старые не теряются. |
| Redis — Кэш | На диск ничего не пишется; при заполнении удаляются самые давно использованные ключи (allkeys-lru). Только для сессий и кэша. |
Восстановленная копия всегда создаётся с той же версией и типом.
Расширения PostgreSQL
На странице базы → Настройки → Расширения владелец команды включает и выключает расширения. Предлагается только этот список:
btree_gin, btree_gist, citext, cube, earthdistance, fuzzystrmatch, hstore, intarray, ltree, pg_trgm, pgcrypto, tablefunc, unaccent, uuid-ossp — а также vector в базе с pgvector и postgis, postgis_topology в базе с PostGIS.
Логин приложения (app) не суперпользователь: он владеет своей базой и схемой. Расширения, которым нужен суперпользователь (vector, postgis), включаются переключателем выше; доверенные (pgcrypto, pg_trgm, uuid-ossp, citext, …) работают и из ваших миграций.
Расширение, которое использует таблица или индекс, выключить нельзя — сначала уберите их. TimescaleDB, pg_stat_statements и pg_cron недоступны.
Логин только для чтения
Для BI-инструмента (Metabase, Grafana) или аналитика владелец команды может создать логин readonly на странице базы → Обзор → Логин только для чтения (PostgreSQL, MySQL, MongoDB). Он читает все таблицы, в том числе созданные позже, и ничего не может записать. Новый пароль сразу заменяет старый. Пароль видит только владелец.
Лимит подключений и пулинг
PostgreSQL принимает 20 подключений одновременно, MySQL — 30. Держите пул приложения небольшим (Prisma: ?connection_limit=5 в DATABASE_URL). Встроенного пулера (PgBouncer) пока нет.
Размеры и цены
| Размер | Память | Цена в месяц |
|---|---|---|
| 500 MB | 128 MiB | Бесплатно — одна на команду |
| 1 GB | 128 MiB | 9 кредитов (9 000 сум) |
| 3 GB | 256 MiB | 19 кредитов (19 000 сум) |
| 5 GB | 256 MiB | 29 кредитов (29 000 сум) |
MySQL получает не меньше 256 MiB памяти, MongoDB — не меньше 384 MiB при любом размере: в меньшем они не запускаются.
Размер можно увеличить позже. Актуальные цены показаны в кабинете в окне добавления базы.
Резервные копии (backup)
Копия баз PostgreSQL, MongoDB, MySQL и Redis автоматически создаётся каждую ночь и хранится в другом месте.
- Хранятся: последние 7 ежедневных, 4 еженедельных и 3 ежемесячных копии.
- Любую копию можно скачать (PostgreSQL — файл
pg_dump; MongoDB — файлmongodump --archive --gzip; MySQL — сжатый gzip SQL-файлmysqldump; Redis — файл RDB) или перед рискованной операцией снять копию текущего состояния. - Восстановление никогда не перезаписывает существующую базу. Копия разворачивается рядом как новая база, переменные приложений не меняются — проверьте и переключитесь сами.
- Восстановление выполняет только владелец команды, подтверждая его вводом имени базы.
Копия Redis тоже восстанавливается в новый Redis, а не поверх работающего.