透過 Firebase 控制台管理 Cloud Firestore

使用 Firebase 主控台時，您可以對 Cloud Firestore 執行下列操作：

• 查看、新增、編輯及刪除資料。
• 建立及更新 Cloud Firestore 安全性規則。
• 管理索引。
• 監控使用情況。

查看資料

您可以在 Firebase 控制台查看所有 Cloud Firestore 資料。在 Cloud Firestore「Data」(資料) 分頁標籤中按一下文件或集合，即可開啟該項目中的巢狀資料。

開啟特定路徑

如要開啟特定路徑的文件或集合，請使用「Edit path」按鈕 ：

篩選集合中的文件

如要篩選集合中列出的文件，請使用「Filter list」按鈕 。

不存在的祖系文件

即使文件的一或多個祖係不存在，文件仍可能存在。例如，即使祖系文件 /mycoll/mydoc 不存在，路徑 /mycoll/mydoc/mysubcoll/mysubdoc 中的文件仍可能存在。Cloud Firestore 資料檢視器會顯示不存在的祖系文件，如下所示：

• 在文件集合的清單中，不存在的祖系文件的文件 ID 會以斜體顯示。
• 在不存在的祖系文件資訊面板中，資料檢視器指出文件不存在。

警告： 雖然不存在的祖系文件顯示在控制台中，但這些文件不會出現在查詢和快照中。您必須建立文件，才能納入查詢結果。

查詢資料

您可以在 Cloud Firestore「資料」頁面的「查詢建構工具」分頁中查詢文件。

1. 前往 Cloud Firestore「Data」頁面

2. 按一下「Query builder」分頁標籤。

3. 選取查詢範圍。

   選取「Collection」(集合) 即可查詢單一集合。請在文字欄位輸入集合的路徑

   選取「Collection group」，查詢具有相同 ID 的所有集合。在「Collection group」(集合群組) 欄位中，輸入集合群組 ID。

   資料表會自動顯示來自指定集合或集合群組中的文件。

4. 按一下「新增至查詢」即可篩選傳回的文件集。根據預設，「查詢產生器」會新增 WHERE 子句。您可以使用下拉式選單和文字欄位修改這個子句，也可以變更為其他可用的子句。如要繼續建立更複雜的查詢，請按一下「Add to query」(新增至查詢)。

   如要移除查詢子句，請按一下移除按鈕 。如要移除所有查詢子句，請按一下「Clear」(清除)。

   注意： 查詢必須符合 Cloud Firestore 查詢規定和限制。否則，查詢失敗且頁面會傳回錯誤，說明查詢失敗的原因。

5. 按一下「Run」(執行)，從資料庫擷取結果。

查詢的相關規定和限制

使用查詢產生器時，請留意下列查詢相關規定和限制。

• 所有查詢都必須由一或多個索引支援。如果資料庫找不到可支援查詢的索引，則會傳回錯誤，其中包含建構所需索引的連結。

• ORDER BY 子句必須與 WHERE 子句中的欄位相符，且順序相同。根據預設，結果會按照文件 ID 排序。如要依據其他欄位 (==) 以外的任何欄位進行篩選，請為該欄位新增 ORDER BY 子句。

• 範圍 (<、<=、>、>=) 但不等於 (!=、not-in) 查詢子句必須篩選相同欄位。

如需其他限制，請參閱查詢限制。

管理資料

在 Cloud Firestore 中，您可以將資料儲存在文件中，並將文件整理成集合。開始新增資料前，請先進一步瞭解 Cloud Firestore 資料模型。

您可以從 Firebase 控制台新增、編輯及刪除文件和集合。如要管理資料，請開啟「Cloud Firestore」部分的「資料」分頁：

注意： 在主控台中執行的讀取、寫入及刪除作業會計入 Cloud Firestore 用量。某些主控台活動 (例如檢視包含多個欄位的文件) 可能會產生多項作業。

新增資料

1. 按一下「新增集合」，然後輸入集合名稱，然後點選「下一步」。
2. 輸入特定文件 ID 或點選「自動 ID」，然後為文件中的資料新增欄位。
3. 按一下「Save」。新的集合和文件就會顯示在資料檢視器中。
4. 如要在珍藏內容中加入更多文件，請按一下「新增文件」。

編輯資料

1. 按一下集合即可查看文件，然後點選文件來查看欄位和子集合。
2. 按一下欄位即可編輯欄位值。如要在所選文件中新增欄位或子集合，請按一下「新增欄位」或「新增集合」。

刪除資料

如何刪除產品素材資源集合：

1. 選取要刪除的產品素材資源集合。
2. 按一下文件欄頂端的選單圖示，然後點選「刪除集合」。

如何刪除文件或文件中的所有欄位：

1. 選取要刪除的文件。
2. 按一下文件詳細資料欄頂端的選單圖示。選取「刪除文件」或「刪除文件欄位」。

刪除文件也會一併刪除該文件中的所有巢狀資料，包括任何子集合。不過，刪除文件的欄位並不會刪除文件的子集合。

如何刪除文件中的特定欄位：

1. 選取文件即可查看欄位。
2. 在要刪除的欄位旁，按一下刪除圖示。

管理 Cloud Firestore 安全性規則

如要在 Firebase 控制台中新增、編輯及刪除 Cloud Firestore 安全性規則，請前往「Cloud Firestore」部分的「規則」分頁。進一步瞭解如何設定及自訂規則。

管理索引

如要為查詢建立新索引及管理現有索引，請透過 Firebase 控制台前往「Cloud Firestore」部分的「Indexes」分頁。進一步瞭解如何管理索引。

監控使用情形

如要監控 Cloud Firestore 用量，請開啟 Firebase 控制台中的 Cloud Firestore用量分頁。您可以利用這個資訊主頁測量不同時間範圍的用量。