使用Firebase 控制台時,您可以在 Cloud Firestore 上執行以下操作:
- 查看、添加、編輯和刪除數據。
- 創建和更新 Cloud Firestore 安全規則。
- 管理索引。
- 監控使用情況。
查看數據
您可以在 Firebase 控制台中查看所有 Cloud Firestore 數據。在 Cloud Firestore數據選項卡中,點擊文檔或集合以打開嵌套在該項目中的數據。
打開特定路徑
要在特定路徑打開文檔或集合,請使用編輯路徑按鈕
:過濾集合中的文檔
要過濾集合中列出的文檔,請使用過濾列表按鈕
。不存在的祖先文檔
即使一個或多個其祖先不存在,文檔也可以存在。例如,即使祖先文檔/mycoll/mydoc
不存在,路徑/mycoll/mydoc/mysubcoll/mysubdoc
中的文檔也可以存在。 Cloud Firestore 數據查看器顯示不存在的祖先文檔,如下所示:
- 在集合的文檔列表中,不存在的祖先文檔的文檔 ID 以斜體顯示。
- 在不存在的祖先文檔的信息面板中,數據查看器指出該文檔不存在。
查詢數據
您可以在 Cloud Firestore 數據頁面的查詢構建器選項卡中查詢文檔。
單擊查詢構建器選項卡。
選擇一個查詢範圍。
選擇Collection查詢單個集合。在文本字段中,輸入集合的路徑。
選擇Collection group查詢具有相同 ID 的所有集合。在集合組字段中,輸入集合組 ID。
該表將自動顯示來自指定集合或集合組的文檔。
單擊“添加到查詢”以過濾返回的文檔集。默認情況下,查詢生成器添加一個
WHERE
子句。您可以使用下拉菜單和文本字段修改此子句,或更改為其他可用子句之一。要繼續構建更複雜的查詢,請單擊添加到查詢。要刪除查詢子句,請單擊它的刪除按鈕
。要刪除所有查詢子句,請單擊清除。單擊運行以從數據庫中檢索結果。
查詢要求和限制
在使用查詢生成器時,請記住以下查詢要求和限制。
所有查詢都必須由一個或多個索引支持。如果數據庫找不到支持查詢的索引,它將返回一個錯誤,其中包含構建所需索引的鏈接。
ORDER BY
子句必須與WHERE
子句中的字段匹配,並且順序相同。默認情況下,結果按文檔 ID 排序。如果您使用等式 (==
) 以外的任何其他字段進行過濾,請為該字段添加一個ORDER BY
子句。範圍(
<
、<=
、>
、>=
)和不等於(!=
、not-in
)查詢子句必須在同一個字段上進行過濾。
有關其他限制,請參閱查詢限制。
管理數據
在 Cloud Firestore 中,您將數據存儲在文檔中並將文檔組織到集合中。在開始添加數據之前,請詳細了解Cloud Firestore 數據模型。
您可以從 Firebase 控制台添加、編輯和刪除文檔和集合。要管理您的數據,請打開Cloud Firestore部分中的數據選項卡:
添加數據
- 單擊添加集合,然後輸入您的集合名稱並單擊下一步。
- 輸入特定文檔 ID 或點擊自動 ID ,然後為文檔中的數據添加字段。
- 單擊保存。您的新集合和文檔出現在數據查看器中。
- 要向集合中添加更多文檔,請單擊添加文檔。
編輯數據
- 單擊一個集合以查看其文檔,然後單擊一個文檔以查看其字段和子集合。
- 單擊一個字段以編輯其值。要將字段或子集合添加到所選文檔,請單擊添加字段或添加集合。
刪除數據
要刪除集合:
- 選擇要刪除的集合。
- 單擊文檔列頂部的菜單圖標,然後單擊刪除集合。
要刪除文檔或其所有字段:
- 選擇要刪除的文檔。
- 單擊文檔詳細信息列頂部的菜單圖標。選擇刪除文檔或刪除文檔字段。
刪除文檔會刪除該文檔中的所有嵌套數據,包括任何子集合。但是,刪除文檔的字段不會刪除其子集合。
要刪除文檔中的特定字段:
- 選擇文檔以查看其字段。
- 單擊要刪除的字段旁邊的刪除圖標。
管理 Cloud Firestore 安全規則
要從 Firebase 控制台添加、編輯和刪除 Cloud Firestore 安全規則,請轉到Cloud Firestore部分的規則選項卡。了解有關設置和自定義規則的更多信息。
管理索引
要從 Firebase 控制台為您的查詢創建新索引並管理現有索引,請轉到Cloud Firestore部分中的索引選項卡。了解有關管理索引的更多信息。
監控使用情況
要監控您的 Cloud Firestore 使用情況,請打開 Firebase 控制台中的 Cloud Firestore使用情況選項卡。使用儀表板來衡量您在不同時間段內的使用情況。