📌 firebase-data-connect 是什么？

想用关系型数据库，又想要 GraphQL 的灵活？Firebase Data Connect 把 PostgreSQL 和 GraphQL 结合起来。firebase-data-connect 是官方技能，让 AI 帮你搭好这套数据层。

它让关系数据和 GraphQL 查询在 Firebase 里协同工作，既有 SQL 的强一致，又有 GraphQL 的类型安全。

🧩 核心功能

连接 PostgreSQL：配置 Cloud SQL 实例并连接。

GraphQL 建模：用 GraphQL schema 定义数据模型。

查询与变更：生成查询和变更操作。

客户端接入：在应用里安全地读写数据。

👍 优点

关系库 + GraphQL：类型安全。

强一致：适合事务场景。

和 Firebase 生态打通。

⚠️ 不足与局限

相对 Firestore 更复杂。

需了解 GraphQL 和 SQL。

Cloud SQL 有成本。

🙋 适合谁用

后端/全栈开发者：用关系库做 Firebase 应用。

团队：需要强一致和复杂查询的场景。

🛠️ 第一次安装

前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：

bash
npx skills add firebase/agent-skills --skill firebase-data-connect

CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用。

✍️ 上手：几个真实例子

场景一：建模

提示词
帮我用 Data Connect 连一个 PostgreSQL，定义用户和订单的 GraphQL schema。

场景二：查询

提示词
帮我写一个查询订单的 GraphQL 操作。

🎯 典型应用场景

关系数据：PostgreSQL。

GraphQL：类型安全查询。

全栈：数据层。

⚖️ 和类似方案对比

和"Firestore"相比，Data Connect 的价值是"关系型 + GraphQL"——适合需要强一致、复杂关联查询的场景；和"直接写 SQL"相比，它又多了 GraphQL 的类型安全和灵活查询。

💡 常见问题 FAQ

问：schema 怎么设计？
先设计好 schema 再写查询。

问：连接串安全吗？
密钥走密钥管理，别硬编码。

问：和 Firestore 选哪个？
复杂关系、事务用 Data Connect，实时简单用 Firestore。

问：Cloud SQL 贵吗？
有成本，按需选择。

📌 总结

总的来说，firebase-data-connect 的价值在于把原本繁琐、重复、容易出错的工作，变成几句对话就能搞定。如果你正好是它的目标用户，装一个试试——成本很低，上手只要几分钟，带来的效率提升却实实在在。如果需求比较轻量，也可以先让 AI 演示一遍再决定是否长期使用。

🤖 适合哪些 AI 工具

Firebase 官方 Skill，Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。