計費示例

僅適用於 Cloud Firestore Enterprise 版。

本頁面提供範例，說明在一些常見情境中，如何計算帳單單位。請注意，根據查詢計畫、資料形狀和可用索引等因素，每個查詢處理的資料可能有所不同。

建議使用「查詢說明」功能，進一步瞭解特定查詢的成本和效能。

讀取作業

大多數讀取作業都涉及對特定文件執行點讀取，或根據 ID 掃描一系列資料。讀取作業會消耗讀取單位。讀取單位是以 4 KiB 為一組計算。請參閱以下範例。

Point reads

點讀的計費範例如下：

  • 讀取單一 1 KiB 文件。消耗：1 個讀取單位
  • 單一 4 KiB 文件的點讀取。消耗：1 個讀取單位
  • 單一 1 MiB 文件的點讀取作業。耗用量：256 個讀取單位
  • 讀取 100 份文件，每份 1 KiB。耗用：100 個讀取單位

掃描

下列範例包含掃描文件或索引項目的情境。

掃描文件

  • 查詢掃描 100 份文件，每份 1 KiB。消耗量：25 個讀取單位

掃描索引

無論掃描的是文件還是索引，掃描費用 (以位元組為單位) 都相同。不過，索引項目通常較小。因此，這些方法通常能以更具成本效益的方式掃描資料。

  • 查詢，掃描 100 個索引項目，每個項目 1 KiB。耗用：25 個讀取單位。
  • 查詢會掃描 100 個索引項目，每個項目 128 個位元組。耗用：4 個讀取單位。

文件或索引項目大小下限

在某些情況下，您可能不需要讀取文件或索引項目的內容，即可滿足查詢。包括簡單的計數查詢，例如計算集合中的文件總數。在這些情況下，系統會對掃描的每個項目收取至少 32 個位元組的費用。

  • 計算集合中的文件數量。查詢會掃描集合中的 1000 個項目。消耗：8 個讀取單位。

掃描和點讀的組合

許多查詢會結合掃描和點讀，以滿足作業需求。

  • 查詢會掃描 128 個索引項目，每個項目 256 個位元組，並對 128 份文件執行點讀取作業，每份文件 4 KiB。消耗：136 個讀取單位，包括：
    • 點讀取 128 個讀取單位
    • 索引掃描作業的讀取單位為 8 個

查詢說明

查詢說明可協助您瞭解資料庫如何執行查詢。您可根據這些詳細資料最佳化查詢。

使用「查詢說明」時，須支付下列費用：

  • 查詢說明 (執行查詢)：會產生查詢費用。
  • 使用「僅限計畫」選項的查詢說明。消耗：1 個讀取單位 (查詢的最低費用)

寫入作業

系統會根據作業期間建立、修改或刪除的文件和索引大小，收取寫入作業 (建立、更新和刪除) 的費用。寫入作業會耗用寫入單位。寫入單位是以 1 KiB 為一組計算。

簡單的寫入作業 (例如依文件 ID 更新) 只會產生寫入費用。 如果寫入作業需要查詢才能完成，則會額外產生與查詢相關的讀取費用。

請參閱以下範例。

建立

  • 建立不含索引的新 10 KiB 文件。消耗：10 個寫入單位
  • 在集合中建立 1 KiB 的文件，其中包含 1 個 256 位元組的索引項目。消耗：2 個寫入單位

更新

  • 透過文件 ID 尋找 10 KiB 的文件，並更新集合中沒有索引的文件。消耗：10 個寫入單位
  • 依文件 ID 尋找 1 KiB 的文件，並更新 1 個欄位，其中包含 1 個 256 位元組的索引項目。消耗：3 個寫入單位。注意：在這種情況下更新索引項目會耗用 2 個寫入單位，一個用於刪除，一個用於重新建立索引項目。
  • 依文件 ID 尋找 1 KiB 的文件，但不更新任何內容 (沒有變更)。消耗：1 個寫入單位 (最低寫入費用)
  • 查詢集合中的所有 1 KiB 文件 (掃描 1, 000 份文件)，並在集合中插入新的 256 位元組欄位 (集合中沒有索引)：1,000 個讀取單位和 1, 000 個寫入單位。

刪除

  • 刪除 1 KiB 的文件，該文件在集合中具有 1 個索引。消耗：2 個寫入單位
  • 刪除 1 KiB 的文件，該文件在集合中沒有索引。消耗：1 個寫入單位

索引建構

索引建構作業會針對建構期間建立或修改的索引項目收費。只要新增或移除索引定義，就會產生這些費用。索引項目的計費方式與寫入作業相同，每 1 KiB 會產生 1 個寫入單位。

  • 為含有 500 份文件的集合建立新索引，每個索引項目為 1 KiB。耗用 500 個寫入單位。
  • 刪除含有 500 份文件的集合的現有索引，每個刪除的索引項目為 1 KiB。耗用 500 個寫入單位。