firebase-data-connect
Создаёт и разворачивает бэкенды Firebase Data Connect на PostgreSQL с GraphQL-схемой и типобезопасными SDK. Полезен при работе с реляционными базами данных, запросами, транзакциями и настройкой авторизации в Firebase.
Что делает навык
Firebase SQL Connect (ранее Data Connect) — это сервис реляционных баз данных на базе Cloud SQL для PostgreSQL, предоставляющий GraphQL-схему, автоматически генерируемые запросы и типобезопасные SDK. Он решает задачи создания бэкендов с поддержкой CRUD, транзакций, авторизации и сложных запросов к реляционным данным.
Когда применять
- Создание типобезопасных API для веб-приложений (TypeScript), Android (Kotlin) или iOS (Swift) с использованием автоматически сгенерированных SDK.
- Реализация сложных реляционных запросов, включая транзакции, апсерты (_upsert) и фильтрацию, с использованием Native GraphQL.
- Настройка авторизации на уровне строк и публичного доступа к данным с помощью директив @auth, @check и @redact.
- Использование расширенных возможностей PostgreSQL, таких как PostGIS или оконные функции, через Native SQL.
Как работает
- Определите модель данных в файле schema/schema.gql, используя типы GraphQL, директивы @table, @col и отношения (@ref).
- Напишите запросы (queries.gql) и мутации (mutations.gql) в папке connector/, добавив логику авторизации и транзакций.
- Настройте генерацию SDK в connector.yaml, указав целевые платформы (javascriptSdk, kotlinSdk, swiftSdk) и директории вывода.
- Запустите npx -y firebase-tools@latest dataconnect:compile для проверки корректности схемы и операций.
- Сгенерируйте типобезопасный код клиента командой npx -y firebase-tools@latest dataconnect:sdk:generate.
- Для локальной разработки запустите эмулятор через npx -y firebase-tools@latest emulators:start --only dataconnect и протестируйте приложение.
Примеры запросов агенту
Что понадобится
- Установленный и инициализированный Firebase CLI (firebase-tools@latest).
- Активный Firebase проект с подключенным Cloud SQL для PostgreSQL.
- Локальная среда с эмулятором Firebase для разработки и тестирования.
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.