Найти в Дзене
Vibecode Wiki

Supabase: Полный гид для новичков, или как разобраться с базами данных

В этой статье я расскажу, что такое Supabase и зачем нужна база данных . Всё шаг за шагом, с примерами, чтобы вы не повторяли мои ошибки. Мы пройдём от "Что это такое?" до "Как заставить ИИ делать миграции за тебя", плюс как получить access token, чтобы ИИ сам настраивал всё, и промпты для ИИ с минимумом ручной работы. И да, это для новичков: никаких глубоких техник, только то, что реально нужно для старта. Представьте: вы хотите базу данных, но не просто SQL-таблицы, а полный бэкенд-стек. Supabase — это открытая альтернатива Firebase, но построенная на PostgreSQL (мощная реляционная БД). Это платформа, которая даёт вам: Supabase бесплатен для старта, масштабируется и интегрируется с ИИ-инструментами. Главное преимущество: всё интегрировано с Row Level Security (RLS) — вы контролируете доступ на уровне строк в БД, чтобы юзеры видели только свои данные. Как новичок, я сначала думал: "Зачем мне это, если ИИ может сгенерить локальную БД?" Но реальность: аппы растут, юзеры приходят, данные
Оглавление

В этой статье я расскажу, что такое Supabase и зачем нужна база данных . Всё шаг за шагом, с примерами, чтобы вы не повторяли мои ошибки. Мы пройдём от "Что это такое?" до "Как заставить ИИ делать миграции за тебя", плюс как получить access token, чтобы ИИ сам настраивал всё, и промпты для ИИ с минимумом ручной работы. И да, это для новичков: никаких глубоких техник, только то, что реально нужно для старта.

Что такое Supabase?

Представьте: вы хотите базу данных, но не просто SQL-таблицы, а полный бэкенд-стек. Supabase — это открытая альтернатива Firebase, но построенная на PostgreSQL (мощная реляционная БД). Это платформа, которая даёт вам:

  • Базу данных: Полноценный Postgres с реалтайм-обновлениями, бэкапами и расширениями.
  • Авторизацию (Auth): Логины через email, пароль, OAuth (Google, GitHub и т.д.), даже SMS-OTP.
  • Хранение файлов (Storage): Загружайте изображения, видео, документы — с контролем доступа.
  • Реалтайм: Данные обновляются в реальном времени, как в чате или дашборде.
  • Edge Functions: Серверные функции, которые выполняются близко к юзерам для низкой задержки (типа AWS Lambda, но проще).

Supabase бесплатен для старта, масштабируется и интегрируется с ИИ-инструментами. Главное преимущество: всё интегрировано с Row Level Security (RLS) — вы контролируете доступ на уровне строк в БД, чтобы юзеры видели только свои данные.

Зачем Supabase нужна?

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

  • Простота: Дашборд как в Firebase — создавай таблицы мышкой, но под капотом мощный SQL.
  • Интеграция с ИИ: Через MCP (Model Context Protocol) ИИ вроде Claude Code может напрямую работать с твоей БД — генерировать схемы, миграции, даже обновлять.
  • Без DevOps: Нет серверов, хостинга — всё в облаке, с глобальным CDN.
  • Бесплатно для тестов: 500 MB БД, 1 GB storage, 50k юзеров — хватит на MVP.
  • Масштаб: Когда вырастешь, плати за Pro ($25/мес) — unlimited юзеры, больше ресурсов.

По сравнению с чистым Postgres: Supabase добавляет реалтайм, auth, storage — не нужно клеить сервисы вручную. Лучше Firebase для тех, кто любит SQL и открытый код.

Как создать базу: Шаг за шагом

Ок, давайте разберёмся, как стартовать.

  1. Регистрация: Иди на supabase.com и зарегистрируйся через GitHub, email или Google. Бесплатно.
  2. Создай проект: После логина кликни "New Project". Выбери организацию (по умолчанию твоя), имя проекта, регион (ближе к юзерам для скорости), пароль для БД (запомни!).Проект создаётся за минуты. Ты получишь URL проекта (типа https:// .supabase.co) и анонимный ключ.

Готово! База создана. Теперь подключим.

Как получить ключи и подключить к аппу

Ключи — это API-креды для доступа. В дашборде иди в Settings > API.

  • URL: https:// .supabase.co
  • anon key: Публичный ключ для анонимного доступа.
  • service_role key: Секретный для админ-доступа (не в клиенте!).

Сохрани эти данные.

Как получить access token, чтобы ИИ мог сам настраивать всё

Чтобы ИИ (типа Claude Code или Codex) мог полностью управлять твоим Supabase проектом — создавать таблицы, миграции, настраивать auth и т.д. — нужен Personal Access Token (PAT). Это долгоживущий токен для Management API Supabase. Он даёт ИИ права как у твоего аккаунта, так что храни в секрете!

Шаги:

  1. Залогинься в Supabase dashboard.
  2. Иди в Account > Access Tokens (или напрямую dashboard/account/tokens).
  3. Кликни "Generate new token". Дай имя (типа "AI Integration"), укажи scopes если нужно (по умолчанию все), и скопируй токен. Он показывается только раз!
  4. Используй в заголовке: Authorization: Bearer

Для ИИ: Включи этот токен в промпты или настройки ИИ (см. ниже). ИИ сможет вызывать Management API для автоматизации: list projects, create branches, run queries и т.д. Для CLI-подобных действий — ИИ может генерировать команды с supabase login --token .

Важно: PAT для management, не путай с project keys (anon/service_role). Для админ-доступа в проекте используй service_role, но PAT — для глобального контроля.

Как подключить через ИИ Codex App (или Claude Code) с минимумом ручной работы

Supabase интегрируется с AI-tools через MCP (Model Context Protocol).

Промпт для подключения Supabase к проекту:

"Подключи Supabase к моему проекту. Используй эти ключи:

URL = https:// .supabase.co,

anon key = ,

service_role key = ,

personal access token = .

Сгенерируй код для createClient, добавь .env файл, настрой auth и RLS для таблицы users. Минимизируй мой input — сделай всё сам."

ИИ сгенерит: .env, import, client init, примеры signUp/signIn.

Промпт для полной установки проекта:

"Я новичок. Настрой весь Supabase проект для нашего приложения: создай таблицы. Используй предоставленные ключи. Сгенерируй полный код для нашего проекта, интеграции, миграции и деплой. Минимум моих действий — только подтверди."

ИИ возьмёт на себя: Генерацию схем, миграций, код.

Как сделать так, чтобы ИИ сделал миграции

Миграции — изменения схемы. ИИ генерирует SQL, применяет.

Промпт для миграций: "Создай миграцию для таблицы [Название таблицы, либо сразу для всех]. Добавь RLS: owner edit. Примени через API/CLI с PAT. Сгенерируй SQL-файл, выполни push. Автоматически."

ИИ: Создаст файл, симулирует supabase db push.

Для CLI: ИИ настроит supabase login --token .

Лимиты для бесплатных аккаунтов

Беслатный план ($0/мес):

  • БД: 500 MB.
  • Storage: 1 GB.
  • Bandwidth: 5 GB.
  • Юзеры: безлимит, но 50k MAU (ежемесячно).
  • Realtime: 200 подключений, 2 млн сообщений/мес.
  • Functions: 500k вызовов.
  • Пауза: После недели неактивности.
  • Файлы: Макс 50 MB.
  • Логи: 1 день.

Превысил? Перейди на Pro ($25/мес): Больше лимитов, нет паузы, PITR (восстановление во времени).