使用 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「資料」頁面的「查詢建構工具」分頁中查詢文件。
按一下「Query builder」分頁標籤。
選取查詢範圍。
選取「Collection」(集合) 即可查詢單一集合。請在文字欄位輸入集合的路徑
選取「Collection group」,查詢具有相同 ID 的所有集合。在「Collection group」(集合群組) 欄位中,輸入集合群組 ID。
資料表會自動顯示來自指定集合或集合群組中的文件。
按一下「新增至查詢」即可篩選傳回的文件集。根據預設,「查詢產生器」會新增
WHERE
子句。您可以使用下拉式選單和文字欄位修改這個子句,也可以變更為其他可用的子句。如要繼續建立更複雜的查詢,請按一下「Add to query」(新增至查詢)。如要移除查詢子句,請按一下移除按鈕
。如要移除所有查詢子句,請按一下「Clear」(清除)。按一下「Run」(執行),從資料庫擷取結果。
查詢的相關規定和限制
使用查詢產生器時,請留意下列查詢相關規定和限制。
所有查詢都必須由一或多個索引支援。如果資料庫找不到可支援查詢的索引,則會傳回錯誤,其中包含建構所需索引的連結。
ORDER BY
子句必須與WHERE
子句中的欄位相符,且順序相同。根據預設,結果會按照文件 ID 排序。如要依據其他欄位 (==
) 以外的任何欄位進行篩選,請為該欄位新增ORDER BY
子句。範圍 (
<
、<=
、>
、>=
) 但不等於 (!=
、not-in
) 查詢子句必須篩選相同欄位。
如需其他限制,請參閱查詢限制。
管理資料
在 Cloud Firestore 中,您可以將資料儲存在文件中,並將文件整理成集合。開始新增資料前,請先進一步瞭解 Cloud Firestore 資料模型。
您可以從 Firebase 控制台新增、編輯及刪除文件和集合。如要管理資料,請開啟「Cloud Firestore」部分的「資料」分頁:
新增資料
- 按一下「新增集合」,然後輸入集合名稱,然後點選「下一步」。
- 輸入特定文件 ID 或點選「自動 ID」,然後為文件中的資料新增欄位。
- 按一下「Save」。新的集合和文件就會顯示在資料檢視器中。
- 如要在珍藏內容中加入更多文件,請按一下「新增文件」。
編輯資料
- 按一下集合即可查看文件,然後點選文件來查看欄位和子集合。
- 按一下欄位即可編輯欄位值。如要在所選文件中新增欄位或子集合,請按一下「新增欄位」或「新增集合」。
刪除資料
如何刪除產品素材資源集合:
- 選取要刪除的產品素材資源集合。
- 按一下文件欄頂端的選單圖示,然後點選「刪除集合」。
如何刪除文件或文件中的所有欄位:
- 選取要刪除的文件。
- 按一下文件詳細資料欄頂端的選單圖示。選取「刪除文件」或「刪除文件欄位」。
刪除文件也會一併刪除該文件中的所有巢狀資料,包括任何子集合。不過,刪除文件的欄位並不會刪除文件的子集合。
如何刪除文件中的特定欄位:
- 選取文件即可查看欄位。
- 在要刪除的欄位旁,按一下刪除圖示。
管理 Cloud Firestore 安全性規則
如要在 Firebase 控制台中新增、編輯及刪除 Cloud Firestore 安全性規則,請前往「Cloud Firestore」部分的「規則」分頁。進一步瞭解如何設定及自訂規則。
管理索引
如要為查詢建立新索引及管理現有索引,請透過 Firebase 控制台前往「Cloud Firestore」部分的「Indexes」分頁。進一步瞭解如何管理索引。
監控使用情形
如要監控 Cloud Firestore 用量,請開啟 Firebase 控制台中的 Cloud Firestore用量分頁。您可以利用這個資訊主頁測量不同時間範圍的用量。