使用主控台管理 Firestore

您可以在Google Cloud 控制台中執行下列動作,管理 Firestore:

  • 查看、查詢、新增、編輯及刪除資料。
  • 管理索引。

查看資料

您可以在 Google Cloud 控制台中查看所有 Firestore 資料。在 Firestore 資料檢視器中,按一下文件或集合,即可開啟該項目中巢狀結構的資料。

  1. 前往 Google Cloud 控制台的「Databases」頁面。

    前往「資料庫」

  2. 從資料庫清單中選取所需資料庫。

  3. 在導覽選單中,按一下「Firestore Studio」

開啟特定路徑

如要在特定路徑開啟文件或集合,請使用「編輯路徑」按鈕

主控台中的 Firestore 面板檢視畫面,其中醒目顯示「編輯路徑」按鈕。

不存在的祖先文件

即使一或多個上層項目不存在,文件仍可存在。舉例來說,即使祖先文件 /mycoll/mydoc 不存在,路徑 /mycoll/mydoc/mysubcoll/mysubdoc 的文件仍可存在。Firestore 資料檢視器會以下列方式顯示不存在的祖先文件:

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

控制台中的 Firestore 資料檢視器,顯示文件階層,並醒目顯示缺少的文件和警告訊息。

篩選資料

您可以根據欄位值和 ==!->>=<<=innot-inarray-containsarray-contains-any 條件,篩選集合中的文件。舉例來說,您只能顯示欄位 firstname 的值等於 Sam 的文件。如要套用集合篩選器,請按照下列步驟操作:

  1. 按一下集合 ID 旁的篩選按鈕

    主控台中的 Firestore 面板檢視畫面,其中醒目顯示「篩選器」按鈕。

  2. 在「新增篩選器」選單中,選取文件欄位、篩選條件和排序順序。

    Firestore「新增篩選器」面板,顯示依欄位篩選、新增條件、變更排序順序,以及預覽查詢程式碼的選項。

  3. 按一下 [套用]

如要移除集合篩選器,請開啟相同選單,然後按一下「清除篩選器」

查詢資料

您可以在 Firestore Studio 頁面的「查詢建立工具」分頁中查詢文件。

  1. 前往 Google Cloud 控制台的「Databases」頁面。

    前往「資料庫」

  2. 從資料庫清單中選取所需資料庫。

  3. 在導覽選單中,按一下「Firestore Studio」

  4. 按一下「查詢產生器」分頁標籤。

  5. 選取查詢範圍

    選取「集合」即可查詢單一集合。在文字欄位中,輸入集合的路徑。

    選取「集合群組」,即可查詢 ID 相同的所有集合。在「集合群組」欄位中,輸入集合群組 ID。

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

  6. 按一下「新增至查詢」,即可篩選傳回的文件集。根據預設,查詢產生器會新增 WHERE 子句。你可以使用下拉式選單和文字欄位修改這項條款,也可以改用其他可用條款。如要繼續建構更複雜的查詢,請點選「新增至查詢」

    如要移除查詢子句,請按一下移除按鈕 。如要移除所有查詢子句,請按一下「清除」

  7. 按一下「執行」,從資料庫擷取結果。

    查詢建立工具顯示查詢結果。

查詢規定和限制

使用查詢建立工具時,請注意查詢的下列需求和限制。

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

    查詢建立工具,附有為查詢建立必要索引的錯誤訊息。

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

    查詢產生器,其中查詢子句和排序依據子句位於相同欄位。

  • 範圍 (<<=>>=) 和不等於 (!=not-in) 查詢子句必須全部篩選同一個欄位。

如需其他限制,請參閱「查詢限制」。

管理資料

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

您可以在 Firebase 控制台中新增、編輯及刪除文件和集合。如要透過 GCP 控制台管理資料,請前往 Firestore Studio 頁面:

  1. 前往 Google Cloud 控制台的「Databases」頁面。

    前往「資料庫」

  2. 從資料庫清單中選取所需資料庫。

  3. 在導覽選單中,按一下「Firestore Studio」

新增資料

  1. 按一下「開始收集」
  2. 輸入集合 ID。輸入文件 ID。Firestore 會產生文件 ID,但您可以覆寫特定文件 ID。為文件中的資料新增欄位。
  3. 按一下 [儲存]。資料檢視器會顯示新的集合和文件。
  4. 如要將更多文件新增至集合,請按一下「新增文件」

編輯資料

  1. 按一下集合即可查看文件,然後按一下文件即可查看欄位和子集合。
  2. 按一下欄位即可編輯值。如要將欄位或子集合新增至所選文件,請按一下「新增欄位」或「開始集合」

刪除資料

您可以從資料檢視器刪除文件或集合。

如何刪除最愛:

  1. 選取要刪除的集合。
  2. 按一下文件欄頂端的選單圖示,然後按一下「刪除集合」

在文件欄的選單中,按一下「刪除集合」

如要刪除文件,請按照下列步驟操作:

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

刪除文件會一併刪除該文件中的所有巢狀資料,包括任何子集合。

刪除文件的欄位不會刪除子集合。雖然文件內容為空,但文件仍存在,且可能會出現在查詢結果中。

在文件詳細資料欄的內容選單中,按一下「刪除文件」或「刪除文件欄位」

如要刪除文件中的特定欄位,請按照下列步驟操作:

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

按一下刪除圖示,即可從文件移除欄位

管理 Firestore 安全性規則

您可以在 Google Cloud 控制台中查看 Firestore 安全性規則。如要編輯或刪除規則集,請啟用 Firebase,然後使用 Firebase CLI 或 Firebase 控制台

啟用 Firebase

如要編輯 Firestore 安全性規則,請務必為專案啟用 Firebase Google Cloud 。如果未啟用 Firebase,可以從「安全性規則」頁面啟用:

如果專案未啟用 Firebase,系統會顯示「啟用 Firebase SDK」按鈕。

Firestore 安全性規則功能與 Firebase Auth 和 Firebase SDK (網頁、Android、Apple 平台) 緊密整合。如要進一步瞭解 Firebase 和 Firestore,請參閱「開始使用 Firebase」。

查看安全性規則

如要透過 Google Cloud 控制台查看 Firestore 安全性規則,請前往「安全性規則」頁面:

  1. 前往 Google Cloud 控制台的「Databases」頁面。

    前往「資料庫」

  2. 從資料庫清單中選取所需資料庫。

  3. 按一下導覽選單中的「Security Rules」(安全規則)

您可以在「規則」頁面查看規則集。

編輯安全性規則

如要編輯或刪除 Firestore 安全性規則,請使用 Firebase CLI 或 Firebase 控制台。在 Firebase 主控台中,前往「Firestore in Native Mode」(原生模式的 Firestore) 區段的「Rules」(規則) 分頁標籤。進一步瞭解如何設定及自訂規則

管理索引

如要為查詢建立新索引,並透過 Firebase 控制台管理現有索引,請前往「Firestore in Native Mode」(原生模式的 Firestore) 專區的「Indexes」(索引) 分頁標籤。進一步瞭解如何管理索引