Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

使用 Firebase 控制台管理 Cloud Firestore

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

使用Firebase 控制台時,您可以在 Cloud Firestore 上執行以下操作:

  • 查看、添加、編輯和刪除數據。
  • 創建和更新 Cloud Firestore 安全規則。
  • 管理索引。
  • 監控使用情況。

查看數據

您可以在 Firebase 控制台中查看所有 Cloud Firestore 數據。在 Cloud Firestore數據選項卡中,點擊文檔或集合以打開嵌套在該項目中的數據。

打開特定路徑

要在特定路徑打開文檔或集合,請使用編輯路徑按鈕

單擊“編輯路徑”按鈕以打開特定文檔或集合。

過濾集合中的文檔

要過濾集合中列出的文檔,請使用過濾列表按鈕

單擊過濾器列表按鈕以過濾列出的文檔。

不存在的祖先文檔

即使一個或多個其祖先不存在,文檔也可以存在。例如,即使祖先文檔/mycoll/mydoc不存在,路徑/mycoll/mydoc/mysubcoll/mysubdoc中的文檔也可以存在。 Cloud Firestore 數據查看器顯示不存在的祖先文檔,如下所示:

  • 在集合的文檔列表中,不存在的祖先文檔的文檔 ID 以斜體顯示
  • 在不存在的祖先文檔的信息面板中,數據查看器指出該文檔不存在。

控制台中不存在的祖先文檔。

查詢數據

您可以在 Cloud Firestore 數據頁面的查詢構建器選項卡中查詢文檔。

  1. 轉到 Cloud Firestore 數據頁面

  2. 單擊查詢構建器選項卡。

  3. 選擇一個查詢範圍

    選擇Collection查詢單個集合。在文本字段中,輸入集合的路徑。

    選擇Collection group查詢具有相同 ID 的所有集合。在集合組字段中,輸入集合組 ID。

    該表將自動顯示來自指定集合或集合組的文檔。

  4. 單擊“添加到查詢”以過濾返回的文檔集。默認情況下,查詢生成器添加一個WHERE子句。您可以使用下拉菜單和文本字段修改此子句,或更改為其他可用子句之一。要繼續構建更複雜的查詢,請單擊添加到查詢

    要刪除查詢子句,請單擊它的刪除按鈕 。要刪除所有查詢子句,請單擊清除

  5. 單擊運行以從數據庫中檢索結果。

查詢要求和限制

在使用查詢生成器時,請記住以下查詢要求和限制。

  • 所有查詢都必須由一個或多個索引支持。如果數據庫找不到支持查詢的索引,它將返回一個錯誤,其中包含構建所需索引的鏈接。

  • ORDER BY子句必須與WHERE子句中的字段匹配,並且順序相同。默認情況下,結果按文檔 ID 排序。如果您使用等式 ( == ) 以外的任何其他字段進行過濾,請為該字段添加一個ORDER BY子句。

  • 範圍( <<=>>= )和不等於( !=not-in )查詢子句必須在同一個字段上進行過濾。

有關其他限制,請參閱查詢限制

管理數據

在 Cloud Firestore 中,您將數據存儲在文檔中並將文檔組織到集合中。在開始添加數據之前,請詳細了解Cloud Firestore 數據模型

您可以從 Firebase 控制台添加、編輯和刪除文檔和集合。要管理您的數據,請打開Cloud Firestore部分中的數據選項卡

添加數據

  1. 單擊添加集合,然後輸入您的集合名稱並單擊下一步
  2. 輸入特定文檔 ID 或點擊自動 ID ,然後為文檔中的數據添加字段。
  3. 單擊保存。您的新集合和文檔出現在數據查看器中。
  4. 要向集合中添加更多文檔,請單擊添加文檔

編輯數據

  1. 單擊一個集合以查看其文檔,然後單擊一個文檔以查看其字段和子集合。
  2. 單擊一個字段以編輯其值。要將字段或子集合添加到所選文檔,請單擊添加字段添加集合

刪除數據

要刪除集合:

  1. 選擇要刪除的集合。
  2. 單擊文檔列頂部的菜單圖標,然後單擊刪除集合

從文檔列的菜單中單擊刪除集合

要刪除文檔或其所有字段:

  1. 選擇要刪除的文檔。
  2. 單擊文檔詳細信息列頂部的菜單圖標。選擇刪除文檔刪除文檔字段

刪除文檔會刪除該文檔中的所有嵌套數據,包括任何子集合。但是,刪除文檔的字段不會刪除其子集合。

從文檔詳細信息列的上下文菜單中單擊刪除文檔或刪除文檔字段

要刪除文檔中的特定字段:

  1. 選擇文檔以查看其字段。
  2. 單擊要刪除的字段旁邊的刪除圖標。

單擊刪除圖標以從文檔中刪除字段

管理 Cloud Firestore 安全規則

要從 Firebase 控制台添加、編輯和刪除 Cloud Firestore 安全規則,請轉到Cloud Firestore部分的規則選項卡。了解有關設置和自定義規則的更多信息。

管理索引

要從 Firebase 控制台為您的查詢創建新索引並管理現有索引,請轉到Cloud Firestore部分中的索引選項卡。了解有關管理索引的更多信息。

監控使用情況

要監控您的 Cloud Firestore 使用情況,請打開 Firebase 控制台中的 Cloud Firestore使用情況選項卡。使用儀表板來衡量您在不同時間段內的使用情況。