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. 專門指南

根據識別或建立的執行個體版本，開啟並閱讀對應的參考指南：

Standard 版本（references/standard/）

• 佈建：閱讀 provisioning.md
• 安全規則：閱讀 security_rules.md
• SDK 使用：閱讀 web_sdk_usage.md、android_sdk_usage.md、ios_setup.md 或 flutter_setup.md
• 索引：閱讀 indexes.md

Enterprise 版本 / 原生模式（references/enterprise/）

• 佈建：閱讀 provisioning.md

• 資料模型：閱讀 data_model.md

• 安全規則：閱讀 security_rules.md

• SDK 使用：

  [!CRITICAL] 強制閱讀參考文件
  在為 Firestore Enterprise 版本撰寫或修改任何應用程式碼之前，你必須閱讀下方至少一份與目標平台/語言相關的參考文件，以了解特定的架構需求與管線初始化模式。

  閱讀 web_sdk_usage.md、python_sdk_usage.md、android_sdk_usage.md、ios_setup.md 或 flutter_setup.md

• 索引：閱讀 indexes.md