firebase data connect
Builds and deploys Firebase SQL Connect (aka Firebase Data Connect) backends with PostgreSQL securely. Use when designing schemas with tables and relations, writing authorized queries and mutations, configuring real-time data updates, or generating type-safe SDKs. Use when you need a relational database with Firebase, or when the user mentions SQL Connect or Data Connect.
Что делает навык
Firebase SQL Connect (ранее Data Connect) — это сервис релятивной базы данных на базе Cloud SQL для PostgreSQL, предоставляющий GraphQL-схему, автоматически генерируемые запросы/мутации и типобезопасные SDK. Он обеспечивает безопасность по умолчанию, позволяя создавать бэкенды с авторизованными операциями, транзакциями и обновлениями в реальном времени.
Когда применять
- Проектирование реляционных схем с таблицами, связями (one-to-many, many-to-many) и типами данных (UUID, Vector, JSON).
- Написание авторизованных запросов и мутаций с использованием GraphQL, включая фильтрацию, сортировку и пагинацию.
- Реализация сложных операций, таких как апсерты (_upsert), транзакции (@transaction) или использование нативного SQL для расширений PostgreSQL.
- Генерация типобезопасных SDK для различных платформ (Web, Android, iOS, Admin, Flutter) на основе схемы.
- Настройка обновлений данных в реальном времени с помощью директивы @refresh и условий CEL.
Как работает
- Определите модель данных в файле schema/schema.gql, используя директивы @table, @ref и типы данных.
- Напишите запросы и мутации в connector/queries.gql и connector/mutations.gql, добавив логику авторизации (@auth, @check) и безопасности.
- Настройте генерацию SDK в connector.yaml, указав целевые платформы и директории вывода.
- Запустите валидацию схемы и операций с помощью команды npx -y firebase-tools@latest dataconnect:compile.
- Сгенерируйте типобезопасный код SDK командой npx -y firebase-tools@latest dataconnect:sdk:generate.
- Используйте сгенерированный SDK в приложении или разверните конфигурацию в облаке через npx -y firebase-tools@latest deploy --only dataconnect.
Примеры запросов агенту
Что понадобится
- Установленный Firebase CLI (firebase-tools)
- Инициализированный проект Firebase с подключенным Cloud SQL для PostgreSQL
- Доступ к репозиторию с файлами справки (reference/schema.md, reference/operations.md и др.)
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.