Документация / Базы данных

Базы данных: подключение и работа с данными

К проекту подключаются четыре базы: PostgreSQL, MongoDB, Redis и Chroma. Платформа сама создаёт базу и пользователя, а строку подключения добавляет в переменные проекта.

Ниже по шагам: подключение, код для популярных языков, импорт, доступ с компьютера, бэкапы, студия в браузере и управление базами через ИИ-ассистента.

Какие базы есть

БазаДля чегоПеременныеБэкапыДоступ снаружи
PostgreSQL 17Основные данные приложения: пользователи, заказы, контентDATABASE_URLКаждую ночь, хранятся 3 дня; вручную — кнопкой; копия в своё S3 или WebDAVПо белому списку IP
MongoDB 7Документы JSON без жёсткой схемыMONGODB_URI, MONGO_URLНетНет, только приложения команды
Redis 7Кэш, сессии, очереди, pub/subREDIS_URLНет: держите в нём кэш и очередиНет, только приложения команды
Chroma 1.5Векторный поиск для RAG и памяти ИИ-агентовCHROMA_URL, CHROMA_TOKEN и ещё 4НетНет, только приложения команды

Все базы работают на той же площадке, что и приложение, во внутренней сети: задержка минимальная, а из интернета их не видно. У каждого проекта своя база и свой пользователь или токен — проекты команды не видят данные друг друга. Исключение — Redis: он один на команду.

Подключить базу к проекту

  1. 1

    Откройте проект и вкладку «Базы данных»

    Здесь собраны все подключённые базы проекта — каждая на своей подвкладке.
  2. 2

    Нажмите «+ Добавить базу» и выберите базу

    Первое подключение MongoDB или Chroma в команде поднимает контейнер команды — это занимает до пары минут.
  3. 3

    Проверьте переменные

    Строка подключения уже во вкладке «Переменные»: DATABASE_URL, MONGODB_URI, REDIS_URL или CHROMA_*. Вписывать её вручную не нужно.
  4. 4

    Нажмите «Редеплой»

    Приложение перезапустится и прочитает новые переменные. Если новых коммитов нет, пересборки не будет — перезапустится текущая сборка.
  5. 5

    Откройте данные в студии

    Пункт меню «Базы данных» → проект → база. Подробнее — в разделе «Студия баз данных».

Читайте строку подключения из окружения

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

PostgreSQL

PostgreSQL 17. Платформа создаёт кластер команды, в нём отдельную базу и пользователя для проекта, шифрует пароль и добавляет DATABASE_URL в переменные. Строка обычная — postgresql://пользователь:пароль@хост:5432/база, — поэтому Prisma, Drizzle, TypeORM, Sequelize, SQLAlchemy, Django ORM и Laravel работают без дополнительной настройки.

Prisma

prisma
// prisma/schema.prisma
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

При сборке платформа выполняет prisma generate. Применить схему можно двумя способами:

  • включить во вкладке «Базы данных» → PostgreSQL тумблер «Сборка с доступом к БД» — тогда при сборке выполняется prisma db push, а Next.js с generateStaticParams видит базу;
  • или накатывать миграции при запуске приложения:
package.json
{
  "scripts": {
    "build": "prisma generate && next build",
    "start": "prisma migrate deploy && next start"
  }
}

Node.js — драйвер pg

javascript
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

python
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. 1

    Создайте PostgreSQL в проекте

    Если в переменных уже был DATABASE_URL, он сохранится как OLD_DATABASE_URL, а на его место встанет новая база.
  2. 2

    Откройте блок «Импорт из другой базы данных»

    Старая строка подставится в форму сама. Строку можно брать как есть, вместе с пулером Neon: искать DIRECT_URL или адрес без пулера не нужно.
  3. 3

    Нажмите «Запустить импорт»

    Платформа снимет дамп прежней базы и развернёт структуру и данные в новой.
  4. 4

    Проверьте данные и сделайте редеплой

    Посмотрите таблицы в студии, затем удалите из переменных OLD_DATABASE_URL и другие старые строки подключения.

На Vercel каждая функция живёт отдельно, здесь приложение — один постоянный процесс. Настройки клиента под serverless вроде max: 1 и prepare: false не нужны: с обычным пулом запросы идут параллельно.

Доступ с компьютера: DBeaver, psql, prisma db push

По умолчанию порт базы наружу закрыт. Чтобы подключиться со своего компьютера, из CI или облачной IDE:

  1. 1

    Узнайте внешний IP

    На компьютере — сайт 2ip.ru (с VPN адрес другой). В Codespaces, Project IDX, CI и терминале — команда curl ifconfig.me.
  2. 2

    Откройте вкладку «Доступ к БД»

    Добавьте IP в белый список и включите внешний доступ. Подключаться можно только с адресов из списка.
  3. 3

    Скопируйте адрес подключения

    Панель покажет внешний хост и порт. Пользователь, пароль и имя базы — те же, что в DATABASE_URL.
bash
# Проверка из терминала
psql "postgresql://ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@ХОСТ:ПОРТ/БАЗА" -c "select version();"

# Схема Prisma с компьютера
DATABASE_URL="postgresql://ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@ХОСТ:ПОРТ/БАЗА" npx prisma db push

Доступ нужен ненадолго — закройте порт, когда закончите. Без белого списка база из интернета не видна.

Пул соединений PgBouncer

При росте трафика соединений с PostgreSQL становится много, появляются задержки и таймауты. PgBouncer принимает все подключения и раздаёт им ограниченное число настоящих соединений к базе. Включается и настраивается во вкладке PostgreSQL, строка в переменных обновляется сама.

FREEPROBUSINESS
Клиентов через пул100400∞
Соединений к базе502005 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

javascript
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

javascript
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

python
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

javascript
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

python
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 на нескольких репликах

javascript
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

python
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

javascript
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. 1

    Откройте пункт меню «Базы данных»

    Или вкладку «Базы данных» проекта → «Студия: таблицы и запросы». Адрес можно сохранить: /db?project=имя&engine=postgres.
  2. 2

    Выберите проект сверху

    В списке — проекты всех ваших команд, проекты с базами идут первыми.
  3. 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 и подобные.
sql
-- Пример: 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. 1

    Войдите на relaxnet.pro своим аккаунтом

    Тем же, что на relaxdev.ru.
  2. 2

    Добавьте коннектор

    Claude — «+» у поля ввода → «Коннекторы» → «Добавить коннектор» → «Добавить пользовательский коннектор», адрес https://relaxnet.pro/api/mcp (со снимками). Claude Code и Codex — командами ниже.
  3. 3

    Разрешите доступ

    Ассистент откроет вход на relaxnet.pro и попросит согласие. В профиле на relaxnet.pro доступ можно отозвать или оставить только чтение — тогда ассистент видит только инструменты чтения.
bash
# 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_infoPostgreSQL: размер базы, таблицы с числом строк; для таблицы — колонки, индексы и ограничения.
db_queryPostgreSQL: один запрос на чтение, до 200 строк, 20 секунд.
db_executePostgreSQL: изменения и миграции, несколько команд — одной транзакцией, 60 секунд.
mongo_queryMongoDB: коллекции, поиск, подсчёт, агрегации, индексы.
mongo_writeMongoDB: вставка, изменение, замена и удаление документов, создание и удаление коллекций.
redis_keys, redis_getRedis: ключи по шаблону с типом и сроком жизни, значение ключа.
redis_commandRedis: одна команда как в redis-cli. Служебные команды закрыты.
chroma_collections, chroma_getChroma: коллекции и записи с отбором по метаданным, тексту и id.

Что написать ассистенту

text
Подключи 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?+

Владелец и редакторы команды проекта. Наблюдатель команды данных не видит. Запросы выполняются с правами базы проекта, а не администратора.