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

В этой статье я расскажу, что такое 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://<project-ref>.supabase.co) и анонимный ключ.

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

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

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

• URL: https://<project-ref>.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 <your_access_token>

Для ИИ: Включи этот токен в промпты или настройки ИИ (см. ниже). ИИ сможет вызывать Management API для автоматизации: list projects, create branches, run queries и т.д. Для CLI-подобных действий — ИИ может генерировать команды с supabase login --token <your_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://<project-ref>.supabase.co, 
anon key = <your_anon_key>, 
service_role key = <your_service_role_key>, 
personal access token = <your_pat>. 
Сгенерируй код для 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 <your_pat>.

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

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

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

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

### Что читать дальше

• Frontend / backend / database — как не путать зоны ответственности
• Как подключить Яндекс.Метрику и Вебмастер без типовых ошибок
• Почему баги ИИ — это твои баги: ответственность в вайбкодинге