Документация / Базы данных
Базы данных: подключение и работа с данными
К проекту подключаются четыре базы: PostgreSQL, MongoDB, Redis и Chroma. Платформа сама создаёт базу и пользователя, а строку подключения добавляет в переменные проекта.
Ниже по шагам: подключение, код для популярных языков, импорт, доступ с компьютера, бэкапы, студия в браузере и управление базами через ИИ-ассистента.
Какие базы есть
| База | Для чего | Переменные | Бэкапы | Доступ снаружи |
|---|---|---|---|---|
| PostgreSQL 17 | Основные данные приложения: пользователи, заказы, контент | DATABASE_URL | Каждую ночь, хранятся 3 дня; вручную — кнопкой; копия в своё S3 или WebDAV | По белому списку IP |
| MongoDB 7 | Документы JSON без жёсткой схемы | MONGODB_URI, MONGO_URL | Нет | Нет, только приложения команды |
| Redis 7 | Кэш, сессии, очереди, pub/sub | REDIS_URL | Нет: держите в нём кэш и очереди | Нет, только приложения команды |
| Chroma 1.5 | Векторный поиск для RAG и памяти ИИ-агентов | CHROMA_URL, CHROMA_TOKEN и ещё 4 | Нет | Нет, только приложения команды |
Все базы работают на той же площадке, что и приложение, во внутренней сети: задержка минимальная, а из интернета их не видно. У каждого проекта своя база и свой пользователь или токен — проекты команды не видят данные друг друга. Исключение — Redis: он один на команду.
Подключить базу к проекту
- 1
Откройте проект и вкладку «Базы данных»
Здесь собраны все подключённые базы проекта — каждая на своей подвкладке. - 2
Нажмите «+ Добавить базу» и выберите базу
Первое подключение MongoDB или Chroma в команде поднимает контейнер команды — это занимает до пары минут. - 3
Проверьте переменные
Строка подключения уже во вкладке «Переменные»:DATABASE_URL,MONGODB_URI,REDIS_URLилиCHROMA_*. Вписывать её вручную не нужно. - 4
Нажмите «Редеплой»
Приложение перезапустится и прочитает новые переменные. Если новых коммитов нет, пересборки не будет — перезапустится текущая сборка. - 5
Откройте данные в студии
Пункт меню «Базы данных» → проект → база. Подробнее — в разделе «Студия баз данных».
Читайте строку подключения из окружения
Не копируйте пароль в код и в .env репозитория. Приложение берёт строку из переменной окружения — так она обновится сама, если вы перевыпустите пароль или включите пул соединений.
PostgreSQL
PostgreSQL 17. Платформа создаёт кластер команды, в нём отдельную базу и пользователя для проекта, шифрует пароль и добавляет DATABASE_URL в переменные. Строка обычная — postgresql://пользователь:пароль@хост:5432/база, — поэтому Prisma, Drizzle, TypeORM, Sequelize, SQLAlchemy, Django ORM и Laravel работают без дополнительной настройки.
Prisma
// prisma/schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}При сборке платформа выполняет prisma generate. Применить схему можно двумя способами:
- включить во вкладке «Базы данных» → PostgreSQL тумблер «Сборка с доступом к БД» — тогда при сборке выполняется
prisma db push, а Next.js сgenerateStaticParamsвидит базу; - или накатывать миграции при запуске приложения:
{
"scripts": {
"build": "prisma generate && next build",
"start": "prisma migrate deploy && next start"
}
}Node.js — драйвер pg
import pg from "pg";
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
const { rows } = await pool.query(
"SELECT id, email FROM users WHERE created_at > $1",
[new Date("2026-01-01")],
);Python — psycopg и SQLAlchemy
import os
import psycopg
with psycopg.connect(os.environ["DATABASE_URL"]) as conn:
print(conn.execute("SELECT now()").fetchone())
# SQLAlchemy: тот же адрес, только с драйвером в схеме
from sqlalchemy import create_engine
engine = create_engine(os.environ["DATABASE_URL"].replace("postgresql://", "postgresql+psycopg://", 1))Что ещё есть во вкладке PostgreSQL
- «Перевыпустить пароль» — старый пароль перестаёт работать сразу, новый подставляется в переменные проекта, приложение перезапускается.
- «Сборка с доступом к БД» — сборка идёт в одной сети с базой:
prisma db pushи статическая генерация страниц из базы. - «Восстановить из файлов (.sql / .dump)» — загрузка дампа в базу проекта.
- DataLens — ссылка с токеном для дашбордов в Yandex DataLens, подробнее.
- Превью веток могут получать свою базу: только схему или схему с данными, подробнее.
Импорт с Neon, Supabase, Railway и Vercel Postgres
- 1
Создайте PostgreSQL в проекте
Если в переменных уже былDATABASE_URL, он сохранится какOLD_DATABASE_URL, а на его место встанет новая база. - 2
Откройте блок «Импорт из другой базы данных»
Старая строка подставится в форму сама. Строку можно брать как есть, вместе с пулером Neon: искать DIRECT_URL или адрес без пулера не нужно. - 3
Нажмите «Запустить импорт»
Платформа снимет дамп прежней базы и развернёт структуру и данные в новой. - 4
Проверьте данные и сделайте редеплой
Посмотрите таблицы в студии, затем удалите из переменныхOLD_DATABASE_URLи другие старые строки подключения.
На Vercel каждая функция живёт отдельно, здесь приложение — один постоянный процесс. Настройки клиента под serverless вроде max: 1 и prepare: false не нужны: с обычным пулом запросы идут параллельно.
Доступ с компьютера: DBeaver, psql, prisma db push
По умолчанию порт базы наружу закрыт. Чтобы подключиться со своего компьютера, из CI или облачной IDE:
- 1
Узнайте внешний IP
На компьютере — сайт 2ip.ru (с VPN адрес другой). В Codespaces, Project IDX, CI и терминале — командаcurl ifconfig.me. - 2
Откройте вкладку «Доступ к БД»
Добавьте IP в белый список и включите внешний доступ. Подключаться можно только с адресов из списка. - 3
Скопируйте адрес подключения
Панель покажет внешний хост и порт. Пользователь, пароль и имя базы — те же, что в DATABASE_URL.
# Проверка из терминала
psql "postgresql://ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@ХОСТ:ПОРТ/БАЗА" -c "select version();"
# Схема Prisma с компьютера
DATABASE_URL="postgresql://ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@ХОСТ:ПОРТ/БАЗА" npx prisma db pushДоступ нужен ненадолго — закройте порт, когда закончите. Без белого списка база из интернета не видна.
Пул соединений PgBouncer
При росте трафика соединений с PostgreSQL становится много, появляются задержки и таймауты. PgBouncer принимает все подключения и раздаёт им ограниченное число настоящих соединений к базе. Включается и настраивается во вкладке PostgreSQL, строка в переменных обновляется сама.
| FREE | PRO | BUSINESS | |
|---|---|---|---|
| Клиентов через пул | 100 | 400 | ∞ |
| Соединений к базе | 50 | 200 | 5 000 |
| Ожидание свободного соединения | 20 с | 30 с | 60 с |
Бэкапы PostgreSQL
- Автоматически. Копии снимаются каждую ночь и хранятся 3 дня.
- Вручную. Вкладка «Бэкапы» → «Создать бэкап» — перед миграцией или большим импортом.
- В своё хранилище. «Бэкапы» → «Своё хранилище»: любой S3 (Yandex Object Storage, Selectel, VK Cloud, AWS, MinIO) или облачный диск по WebDAV (Яндекс Диск с паролем приложения, Nextcloud). Копия уходит туда каждые 3, 6, 12 или 24 часа, старые удаляются по сроку. Хранилище должно быть закрытым: без ключей не должны открываться ни список, ни файлы, иначе настройка не сохранится.
- Восстановление. Копии — дампы
pg_dump(.dump), загружаются обратно через «Восстановить из файлов».
MongoDB
MongoDB 7. Один контейнер на команду, у каждого проекта своя база и пользователь с правами только на неё. В переменных появляются MONGODB_URI и MONGO_URL — так строку называют Mongoose, шаблоны Railway и большинство примеров. Имя базы уже есть в строке, отдельно его указывать не нужно.
Mongoose
import mongoose from "mongoose";
await mongoose.connect(process.env.MONGODB_URI);
const Order = mongoose.model("Order", new mongoose.Schema({
total: Number,
status: { type: String, default: "new" },
}, { timestamps: true }));
await Order.create({ total: 990 });
const fresh = await Order.find({ status: "new" }).sort({ createdAt: -1 }).limit(20);Официальный драйвер mongodb
import { MongoClient } from "mongodb";
const client = new MongoClient(process.env.MONGODB_URI);
const db = client.db(); // база проекта — из строки подключения
await db.collection("orders").insertOne({ total: 990, status: "new" });
await db.collection("orders").createIndex({ status: 1 });Python — PyMongo
import os
from pymongo import MongoClient
db = MongoClient(os.environ["MONGODB_URI"]).get_default_database()
db.orders.insert_one({"total": 990, "status": "new"})
print(db.orders.count_documents({"status": "new"}))- Порт MongoDB наружу не открыт: Compass и mongosh с компьютера не подключатся. Документы смотрите и правьте в студии.
- Отключение MongoDB удаляет базу проекта вместе с данными. При удалении проекта база удаляется тоже.
- Автоматических бэкапов MongoDB нет: важные данные выгружайте из приложения или фоновой задачи в своё хранилище.
- Перенос проекта с MongoDB на другую площадку пока не поддерживается, а копия проекта (окружение) создаётся без неё.
Redis
Redis 7, доступен на всех тарифах. Один экземпляр с паролем на команду: бот, API и воркер команды могут делить одну очередь или кэш. 512 МБ памяти с политикой allkeys-lru — при заполнении вытесняются ключи, к которым дольше всего не обращались. Строка — в REDIS_URL.
Разделяйте ключи префиксами
Redis общий для проектов команды. Начинайте ключи с имени проекта: shop:cart:42, bot:session:1001.
Node.js — redis и BullMQ
import { createClient } from "redis";
const redis = createClient({ url: process.env.REDIS_URL });
await redis.connect();
await redis.set("shop:greeting", "hello", { EX: 60 });
// Очередь задач на BullMQ (ioredis)
import { Queue, Worker } from "bullmq";
import IORedis from "ioredis";
const connection = new IORedis(process.env.REDIS_URL, { maxRetriesPerRequest: null });
const emails = new Queue("shop-emails", { connection });
await emails.add("welcome", { to: "user@example.com" });
new Worker("shop-emails", async (job) => { /* отправка письма */ }, { connection });Python — redis-py
import os, redis
r = redis.Redis.from_url(os.environ["REDIS_URL"], decode_responses=True)
r.set("bot:last_update", "12345", ex=3600)
print(r.get("bot:last_update"))Socket.io на нескольких репликах
import { createAdapter } from "@socket.io/redis-adapter";
import { createClient } from "redis";
const pub = createClient({ url: process.env.REDIS_URL });
const sub = pub.duplicate();
await Promise.all([pub.connect(), sub.connect()]);
io.adapter(createAdapter(pub, sub));Redis периодически сохраняет снимок на диск, поэтому перезапуск обычно переживает. Но держите в нём кэш, сессии и очереди, а не единственную копию данных.
Chroma — векторная база для RAG
Chroma хранит эмбеддинги — числовые представления текстов — и находит записи по смыслу. На этом строится RAG: бот или ИИ-агент сначала достаёт из базы подходящие фрагменты документации, а потом отвечает. Версия — Chroma 1.5 с API v2.
Один сервер Chroma на команду, у проекта своя база и свой токен: токен другого проекта к ней не подходит. В переменных — CHROMA_URL, CHROMA_HOST, CHROMA_PORT, CHROMA_TOKEN, CHROMA_TENANT и CHROMA_DATABASE. Токен передаётся заголовком x-chroma-token или Authorization: Bearer.
Python — chromadb
import os, chromadb
client = chromadb.HttpClient(
host=os.environ["CHROMA_HOST"], port=int(os.environ["CHROMA_PORT"]),
headers={"x-chroma-token": os.environ["CHROMA_TOKEN"]},
tenant=os.environ["CHROMA_TENANT"], database=os.environ["CHROMA_DATABASE"],
)
docs = client.get_or_create_collection("docs")
docs.add(
ids=["faq-1", "faq-2"],
documents=["Возврат товара — в течение 14 дней", "Доставка по Москве — на следующий день"],
metadatas=[{"source": "faq"}, {"source": "faq"}],
)
print(docs.query(query_texts=["как вернуть заказ"], n_results=2))JavaScript — chromadb
import { ChromaClient } from "chromadb";
const client = new ChromaClient({
path: process.env.CHROMA_URL,
headers: { "x-chroma-token": process.env.CHROMA_TOKEN },
tenant: process.env.CHROMA_TENANT,
database: process.env.CHROMA_DATABASE,
});
const docs = await client.getOrCreateCollection({ name: "docs" });- Эмбеддинги считает ваше приложение: встроенной моделью клиента chromadb или готовыми векторами от OpenAI, GigaChat, YandexGPT или своей модели.
- LangChain и LlamaIndex подключаются по HTTP с теми же хостом, портом, заголовком токена, тенантом и базой.
- Отключение удаляет базу проекта со всеми коллекциями, токен сразу перестаёт работать.
- Автоматических бэкапов нет: исходные документы храните в основной базе или хранилище — по ним коллекцию можно собрать заново.
Студия баз данных
Данные проекта — прямо в браузере, без DBeaver, внешнего доступа и строк подключения. Работает и на телефоне.
- 1
Откройте пункт меню «Базы данных»
Или вкладку «Базы данных» проекта → «Студия: таблицы и запросы». Адрес можно сохранить:/db?project=имя&engine=postgres. - 2
Выберите проект сверху
В списке — проекты всех ваших команд, проекты с базами идут первыми. - 3
Переключите базу
PostgreSQL, MongoDB, Redis или Chroma — из подключённых к проекту.
| База | Что можно |
|---|---|
| PostgreSQL | Таблицы с данными, сортировкой и страницами, структура колонок. Строки с первичным ключом правятся, добавляются и удаляются. SQL-редактор с подсветкой, подсказками таблиц, историей и выгрузкой в CSV, запуск — Ctrl+Enter. |
| MongoDB | Коллекции с числом документов, поиск по фильтру и сортировке — в JSON или как в mongosh: { status: "paid" }, ObjectId("…"). Правка, добавление и удаление документов, агрегации, индексы. |
| Redis | Ключи по шаблону с типом и сроком жизни, значение по типу: строка, хеш, список, множество, сортированное множество, стрим. Консоль команд с историей. |
| Chroma | Коллекции с числом записей и сами записи: id, текст и метаданные. |
- Студия открыта владельцу и редакторам команды: в ней видны и меняются данные.
- Запросы выполняются с правами пользователя базы проекта, а не администратора. Чужие базы команды и файлы сервера недоступны.
- SQL из нескольких команд выполняется одной транзакцией: при ошибке изменения откатываются. Лимит — 60 секунд, в ответе — до 1000 строк каждого результата.
- В консоли Redis закрыты команды настроек сервера, репликации и подписок: CONFIG, MONITOR, SUBSCRIBE и подобные.
-- Пример: 10 последних заказов с суммой больше 1000 ₽
SELECT id, email, total, created_at
FROM orders
WHERE total > 1000
ORDER BY created_at DESC
LIMIT 10;Базы через MCP: Claude, Claude Code, Codex
ИИ-ассистент может сам подключить базу к проекту, посмотреть структуру, выполнить запрос или поправить данные. MCP-сервер работает на relaxnet.pro: аккаунт, проекты и базы там те же, что на relaxdev.ru.
Подключение
- 1
Войдите на relaxnet.pro своим аккаунтом
Тем же, что на relaxdev.ru. - 2
Добавьте коннектор
Claude — «+» у поля ввода → «Коннекторы» → «Добавить коннектор» → «Добавить пользовательский коннектор», адресhttps://relaxnet.pro/api/mcp(со снимками). Claude Code и Codex — командами ниже. - 3
Разрешите доступ
Ассистент откроет вход на relaxnet.pro и попросит согласие. В профиле на relaxnet.pro доступ можно отозвать или оставить только чтение — тогда ассистент видит только инструменты чтения.
# Claude Code: затем /mcp и вход в браузере
claude mcp add --transport http relaxnet https://relaxnet.pro/api/mcp
# Codex: добавить сервер и войти, потом открыть новый чат
codex mcp add relaxnet --url https://relaxnet.pro/api/mcp
codex mcp login relaxnetЕсли коннектор был подключён раньше, отключите его и подключите заново: инструменты для MongoDB, Redis и Chroma появляются после нового согласия.
Инструменты
| Инструмент | Что делает |
|---|---|
databases | Какие базы подключены к проекту: хост, имя базы, переменные. Без паролей и токенов. |
database_connect | Подключает PostgreSQL, MongoDB, Redis или Chroma — как кнопка «+ Добавить базу». |
db_info | PostgreSQL: размер базы, таблицы с числом строк; для таблицы — колонки, индексы и ограничения. |
db_query | PostgreSQL: один запрос на чтение, до 200 строк, 20 секунд. |
db_execute | PostgreSQL: изменения и миграции, несколько команд — одной транзакцией, 60 секунд. |
mongo_query | MongoDB: коллекции, поиск, подсчёт, агрегации, индексы. |
mongo_write | MongoDB: вставка, изменение, замена и удаление документов, создание и удаление коллекций. |
redis_keys, redis_get | Redis: ключи по шаблону с типом и сроком жизни, значение ключа. |
redis_command | Redis: одна команда как в redis-cli. Служебные команды закрыты. |
chroma_collections, chroma_get | Chroma: коллекции и записи с отбором по метаданным, тексту и id. |
Что написать ассистенту
Подключи MongoDB к проекту shop, сделай редеплой и проверь, что приложение запустилось.
Покажи структуру таблицы orders в проекте shop и посчитай заказы по статусам за октябрь.
Добавь в таблицу users колонку phone (text, может быть пустой). Сначала покажи SQL.
Найди в Redis проекта bot ключи session:* без срока жизни и поставь им TTL 1 день.
Сколько записей в коллекции docs в Chroma проекта support и какие у них source в метаданных?- Данные доступны только владельцу и редакторам команды проекта.
- В инструкциях сервера ассистенту сказано смотреть структуру перед изменениями и подтверждать у вас разрушительные запросы: DROP, DELETE и UPDATE без WHERE, FLUSHDB, удаление коллекций.
- Пароли и токены баз ассистент не получает — только имена переменных.
Подробнее о коннекторе — Claude и MCP: подключение по шагам и ИИ-агенты в документации.
Частые вопросы
Переменная DATABASE_URL есть, а приложение её не видит+
Переменные попадают в приложение при запуске. После подключения базы нажмите «Редеплой»: если новых коммитов нет, платформа перезапустит текущую сборку с новыми переменными.
Локально приложение не подключается к базе: ECONNREFUSED или таймаут+
База работает в приватной сети рядом с приложением и снаружи закрыта. Для подключения с компьютера откройте внешний порт во вкладке «Доступ к БД» и добавьте свой IP в белый список.
prisma db push из Codespaces или CI не может достучаться до базы+
У облачной среды свой внешний IP, не такой, как у вашего компьютера. Узнайте его командой curl ifconfig.me и добавьте в белый список во вкладке «Доступ к БД».
Можно ли подключить к одному проекту несколько баз?+
Да. К проекту подключаются PostgreSQL, MongoDB, Redis и Chroma одновременно, каждая получает свою подвкладку во вкладке «Базы данных».
Ключи Redis одного проекта перемешались с ключами другого+
Redis один на команду, его делят все проекты команды. Начинайте ключи с префикса проекта, например shop:cart:42, и ищите по шаблону shop:*.
Как сделать резервную копию MongoDB или Chroma?+
Ночные бэкапы платформа делает для PostgreSQL. Для MongoDB выгружайте важные данные из приложения или фоновой задачи в своё хранилище. Для Chroma храните исходные документы в основной базе или хранилище: по ним коллекцию можно собрать заново.
Кто видит данные в студии и через MCP?+
Владелец и редакторы команды проекта. Наблюдатель команды данных не видит. Запросы выполняются с правами базы проекта, а не администратора.