firebase-firestore

Cloud Firestore 数据库与操作

在设置依赖项、编写数据模型或配置安全规则之前，你必须始终确定 Firestore 实例的版本。

1. 实例选择与版本检测

运行以下命令列出当前 Firestore 数据库：bash npx -y firebase-tools@latest firestore:databases:list

A. 找到实例

1. 对于每个找到的数据库，检查其版本和详细信息：bash npx -y firebase-tools@latest firestore:databases:get <database-id>
2. 询问用户希望针对哪个数据库实例，或者是否希望创建新实例。
3. 确定目标实例后：
   • 如果 edition 为 STANDARD，请遵循 references/standard/ 下的指南。
   • 如果 edition 为 ENTERPRISE 或原生模式，请遵循 references/enterprise/ 下的指南。

B. 未找到实例（或请求新建）

如果没有数据库存在或用户请求新建，默认预配一个 Enterprise 版本数据库，并询问用户使用哪个位置。
运行 npx -y firebase-tools@latest firestore:locations 获取选项列表。
如果适用，建议与其他资源共置。

确定位置后，创建数据库：
bash npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"

继续使用 references/enterprise/ 下的指南。

---

2. 专项指南

根据识别或创建的实例版本，打开并阅读相应的参考指南：

标准版（references/standard/）

• 预配：阅读 provisioning.md
• 安全规则：阅读 security_rules.md
• SDK 使用：阅读 web_sdk_usage.md、android_sdk_usage.md、ios_setup.md 或 flutter_setup.md
• 索引：阅读 indexes.md

企业版 / 原生模式（references/enterprise/）

• 预配：阅读 provisioning.md

• 数据模型：阅读 data_model.md

• 安全规则：阅读 security_rules.md

• SDK 使用：

  [!CRITICAL] 强制参考阅读
  在编写或修改 Firestore 企业版的任何应用程序代码之前，你必须至少阅读以下针对目标平台/语言的相关参考文档之一，以了解特定的架构要求和管道初始化模式。

  阅读 web_sdk_usage.md、python_sdk_usage.md、android_sdk_usage.md、ios_setup.md 或 flutter_setup.md

• 索引：阅读 indexes.md