Cloud Firestore 数据库与操作

在设置依赖项、编写数据模型或配置安全规则之前，你 MUST 始终识别 Firestore 实例版本。

1. 实例选择与版本检测

运行以下命令以列出当前 Firestore 数据库：

npx -y firebase-tools@latest firestore:databases:list

A. 已找到实例

1. 对于找到的每个数据库，检查其 edition 和详细信息：

``bash npx -y firebase-tools@latest firestore:databases:get <database-id> ``

1. 询问用户希望针对哪个数据库实例，或者是否更希望创建新实例。
2. 确定目标实例后：

• 如果 edition 为 STANDARD，请遵循 references/standard/ 下的指南。
• 如果 edition 为 ENTERPRISE 或原生模式，请遵循 references/enterprise/ 下的指南。

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

如果没有数据库或用户请求新建数据库，默认预配 Enterprise 版数据库，并询问用户要使用的位置。运行 npx -y firebase-tools@latest firestore:locations 以获取选项列表。如果适用，建议与其他资源同地部署。

确定位置后，创建数据库：

npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"

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

______________________________________________________________________

2. 专项指南

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

标准版 (references/standard/)

• 预配: 阅读 [provisioning.md](references/standard/provisioning.md)
• 安全规则: 参见 firestore-rules-creation 技能
• SDK 用法: 阅读 [web_sdk_usage.md](references/standard/web_sdk_usage.md)、

[android_sdk_usage.md](references/standard/android_sdk_usage.md)、 [ios_setup.md](references/standard/ios_setup.md) 或 [flutter_setup.md](references/standard/flutter_setup.md)

• 索引: 阅读 [indexes.md](references/standard/indexes.md)

企业版 / 原生模式 (references/enterprise/)

• 预配: 阅读

[provisioning.md](references/enterprise/provisioning.md)

• 数据模型: 阅读 [data_model.md](references/enterprise/data_model.md)

• 安全规则: 参见 firestore-rules-creation 技能

• SDK 用法:

> [!CRITICAL] 必读参考文档 在为 Firestore Enterprise Edition 编写或修改任何应用代码之前，你 MUST 至少阅读以下目标平台/语言的一个相关参考文档，以理解具体架构要求和 pipeline 初始化模式。

阅读 [web_sdk_usage.md](references/enterprise/web_sdk_usage.md)、 [python_sdk_usage.md](references/enterprise/python_sdk_usage.md)、 [android_sdk_usage.md](references/enterprise/android_sdk_usage.md)、 [ios_setup.md](references/enterprise/ios_setup.md) 或 [flutter_setup.md](references/enterprise/flutter_setup.md)

• 索引: 阅读 [indexes.md](references/enterprise/indexes.md)