В этом кратком руководстве показано, как использовать Firebase SQL Connect с вашим инструментом для разработки приложений на основе ИИ, чтобы быстро создавать полнофункциональные реляционные приложения. Оснастив своего агента навыками Firebase Agent Skills, вам не потребуется писать шаблонный код для работы с базой данных или вручную настраивать конечные точки. Вы узнаете, как настроить локальный проект, сконфигурировать своего ИИ-помощника и использовать одну подсказку для генерации безопасной схемы PostgreSQL, операций GraphQL и полноценного фронтенда на React. Полученные знания можно использовать для создания фронтендов для любой из платформ, поддерживаемых Firebase SQL Connect .
Прежде чем начать
Для завершения этого краткого руководства убедитесь, что ваша среда настроена следующим образом. Если вам нужна пошаговая помощь для вашей конкретной операционной системы, см. стандартное руководство по настройке :
- Node.js : Установите Node.js , чтобы запустить Firebase CLI и обеспечить работу сгенерированного вами React-интерфейса.
Firebase CLI : Установите Firebase CLI глобально:
npm install -g firebase-toolsИнструмент для программирования с использованием ИИ : установите современный редактор кода на основе ИИ (например, Antigravity , Android Studio , Cursor или Windsurf).
Обустройте свое рабочее место.
Сначала откройте предпочитаемый вами инструмент для программирования ИИ и создайте новую директорию проекта. Откройте встроенный терминал вашего инструмента и выполните команду инициализации:
firebase init dataconnect
Эта команда поможет вам инициализировать проект. При появлении запроса выберите следующие параметры:
- Создайте новый проект Firebase.
- Пропустить генерацию схемы Gemini
- Создайте новый экземпляр Cloud SQL.
- Создайте шаблон React
- Выберите «Да» , чтобы установить навыки агента для Firebase.
Создайте свое приложение с помощью ИИ.
При установленном Firebase Agent Skills ваш ИИ-помощник сможет генерировать схему SQL Connect, операции и код интерфейса непосредственно из командной строки высокого уровня.
Скопируйте и вставьте один из следующих запросов в своего ИИ-помощника, чтобы сгенерировать бэкэнд, связи с базой данных и фронтенд на React:
Пример 1: Приложение для отзывов о фильмах
Быстрый:
Build a movie review website using Firebase SQL Connect. Customers can browse
a catalog of movies presented in a modern card layout displaying average
ratings and review counts, and leave a review from 1 to 5 stars. A user must
only be allowed to leave a single review per movie. Build a styled React
(Vite) frontend that displays the catalog and dynamically renders a live feed
of new reviews. Compile the database backend and React frontend, seed the
database with sample data, and verify that the application builds cleanly and
all core user flows run successfully.
Пример 2: Витрина интернет-магазина
Быстрый:
Build an online storefront using Firebase SQL Connect. Customers can browse
product cards showing prices and stock levels, manage a shopping cart, and
check out securely. The checkout transaction must atomically verify that
their cart is not empty, check that products are in stock, create the order,
and decrease the product stock, safely rolling back if any step fails.
Build a highly responsive React (Vite) storefront with a polished checkout
process. Compile the database backend and React frontend, seed the database
with sample data, and verify that the application builds cleanly and all
core user flows run successfully.
Пример 3: Блог с несколькими авторами
Быстрый:
Create a multi-author blog platform using Firebase SQL Connect. The homepage
should display published articles formatted in an elegant typographic layout
with comfortable reading line lengths and serif headings. Users should have
access to a secure split-pane writing dashboard built using React (Vite) to
compose posts with a live preview. Compile the database backend and React
frontend, seed the database with sample data, and verify that the
application builds cleanly and all core user flows run successfully.
Что создаёт ваш ИИ-помощник
Когда вы запускаете эти запросы, ваш ИИ-помощник автоматически берет на себя всю сложную техническую работу:
- Схема базы данных (
dataconnect/schema/schema.gql) : Преобразует ваши требования в реляционные таблицы с помощью директивы@table, автоматически управляя внешними и первичными ключами. - Операции GraphQL (
dataconnect/[connector_name]/*.gql) : Генерирует именно те запросы и мутации, которые необходимы вашему приложению, с защитой с помощью директивы@auth. - Сгенерированный SDK (
src/dataconnect/) : Использует Firebase CLI для мгновенной генерации строго типизированного клиентского SDK на основе вашей схемы и операций. - React Frontend (
src/) : Создает полноценное, красиво оформленное React-приложение, которое использует сгенерированный вами SDK для взаимодействия с вашим новым бэкендом.
Развертывание в производственной среде
Чтобы развернуть схему, запросы и мутации в рабочей среде, выполните следующую команду в терминале:
firebase deploy --only dataconnect
После развертывания перейдите в консоль Firebase, чтобы просмотреть свою рабочую схему и выполнять операции непосредственно с вашим экземпляром Cloud SQL.
Следующие шаги
Теперь, когда вы завершили краткое руководство, выполните следующие шаги:
- Изучите репозиторий приложений для быстрого старта и создайте приложение SQL Connect, следуя нашим практическим заданиям.
- Добавляйте данные в свою базу данных и отслеживайте работу службы SQL Connect в консоли Firebase.
- Узнайте больше о разработке схем , запросов и мутаций .
- Узнайте больше о клиентских SDK и административных SDK .