原生模式：配額與限制

本頁面說明原生模式 Cloud Firestore 的要求配額和 Enterprise 版限制。

免費方案用量

Cloud Firestore (原生模式) 提供免費方案，您無須付費即可開始使用 Cloud Firestore (原生模式)。下表列出免費方案的用量。

免費方案額度每日計算，並在太平洋時間午夜重設。

免費方案僅適用於每項專案的一個 Cloud Firestore 資料庫。在沒有免費方案資料庫的專案中，第一個建立的資料庫將享有免費方案。如果刪除套用免費方案的資料庫，下一個建立的資料庫就會套用免費方案。

免費方案 配額
儲存的資料量 1 GiB
讀取單位 每天 50,000 次
即時更新單元 每天 50,000 次
寫入單位 每天 40,000 個
傳出資料移轉 每月 10 GiB

標準限制

下表列出適用於原生模式 Cloud Firestore 的限制。除非另有說明，否則這些都是硬性限制。

資料庫

限制 詳細資料
每項專案的資料庫數量上限

100

如要提高上限，請與支援團隊聯絡。
每項專案的客戶自行管理的加密金鑰 (CMEK) 資料庫數量上限

0

這項功能僅限許可清單中的人員使用，因此預設配額為 0。如要申請提高配額，請填寫 CMEK 存取權要求表單。

集合、文件和欄位

限制 說明
集合 ID 限制
  • 必須使用有效的 UTF-8 字元
  • 長度不得超過 1,500 個位元組
  • 不得包含正斜線 (/)
  • 不得僅包含一個半形句號 (.) 或連續兩個半形句號 (..)
  • 不得與以下規則運算式相符：__.*__
子集合深度上限 100
文件 ID 限制
  • 必須使用有效的 UTF-8 字元
  • 長度不得超過 1,500 個位元組
  • 不得包含正斜線 (/)
  • 不得僅包含一個半形句號 (.) 或連續兩個半形句號 (..)
  • 不得與以下規則運算式相符：__.*__
  • 如果將 Datastore 實體匯入到 Firestore 資料庫中，數字實體 ID 會以 __id[0-9]+__ 的形式顯示
檔案名稱大小上限 6 KiB
檔案大小上限 1 MiB (1,048,576 個位元組)
欄位名稱限制
  • 必須使用有效的 UTF-8 字元
  • 不得與以下規則運算式相符：__.*__
欄位名稱大小上限 1,500 個位元組
欄位路徑限制
  • 必須以一個半形句號 (.) 分隔欄位名稱
  • 可以傳遞為以點分隔 (.) 的區隔字串，其中每個區隔都是簡單的欄位名稱或加上引號的欄位名稱 (定義如下)。
如果欄位名稱符合以下所有條件，即為簡單的名稱：
  • 僅含 a-z、A-Z、0-9 等字元和底線 (_)
  • 開頭不是 0-9
引用的欄位名稱開頭和結尾為反引號字元 (`)。例如，foo.`x&y` 是指巢狀結構在 foo 欄位下的 x&y 欄位。如要使用倒引號字元建構欄位名稱，請使用反斜線字元 (\) 逸出倒引號字元。為方便起見，您可以將欄位路徑做為 FieldPath 物件傳遞，避免使用引號括住欄位名稱 (例如，請參閱 JavaScript FieldPath)。
欄位路徑大小上限 1,500 個位元組
欄位值大小上限 1 MiB 減去 89 個位元組 (1,048,487 個位元組)
對應關係或陣列中欄位的深度上限

20

對應和陣列欄位會使物件的整體深度增加一個層級。舉例來說，下列物件的總深度為三層： 


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

寫入作業和交易

限制 說明
API 請求大小上限 10 MiB
查詢的記憶體限制 128 MiB
交易時間限制 270 秒，閒置到期時間為 60 秒
可在一項 Commit 作業或交易中對一個文件執行的欄位轉換工作數量上限 500

索引

限制 詳細資料
資料庫的索引數量上限

每個文件的索引項目數量上限

40,000
索引中的欄位數量上限 100
索引項目大小上限

7.5 KiB
文件的索引項目大小總和上限

8 MiB

存留時間 (TTL)

限制 詳細資料
資料庫的單一欄位設定數量上限

一個欄位層級設定可以包含相同欄位的多個設定。舉例來說，如果對同一個欄位設定單一欄位索引豁免項目和存留時間政策，則會計為一項欄位設定。

匯出/匯入

以下限制適用於代管匯入及匯出作業：

限制 說明
專案每分鐘允許的匯出與匯入要求總數上限 20
並行匯出與匯入作業的數量上限 50
匯出與匯入要求的集合 ID 篩選器數量上限 100

安全性規則

限制 說明
每項要求的 exists()、get() 和 getAfter() 呼叫數量上限
  • 單一文件要求和查詢要求的上限為 10 項。

  • 多文件讀取作業、交易和批次寫入作業的上限為 20 項。上述限制 (10 項呼叫) 同樣適用於各項作業。

    舉例來說，假設您建立的批次寫入要求含有 3 項寫入作業，而您的安全性規則會使用 2 項文件存取呼叫來驗證各項寫入作業。此時，各項寫入作業會使用 2 項存取呼叫 (上限為 10 項)，批次寫入要求則會使用 6 項存取呼叫 (上限為 20 項)。

超過任一項限制都會引發權限遭拒的錯誤。

系統可能會快取部分的文件存取呼叫，已快取的呼叫不會計入限制中。
巢狀 match 陳述式深度上限 10
一組巢狀 match 陳述式中允許的路徑長度上限 (以路徑區段為單位) 100
一組巢狀 match 陳述式中允許的路徑擷取變數數量上限 20
函式呼叫深度上限 20
函式引數數量上限 7
每個函式的 let 變數繫結上限 10
遞迴或循環函式呼叫的數量上限 0 (不允許)
每個要求中經評估的運算式數量上限 1,000 個
規則集的大小上限 規則集必須遵守兩項大小限制：
  • 從 Firebase 控制台或使用 firebase deploy 透過 CLI 發布的規則集文字來源大小上限為 256 KB。
  • Firebase 處理來源並在後端啟用時，產生的編譯規則集大小上限為 250 KB。

已儲存的查詢限制

值 限制
每個專案的已儲存的查詢數量上限 (包括其他 Google Cloud 產品的已儲存的查詢) 10,000
每項查詢的大小上限 1 MiB