配额和限制

本页面介绍了 Cloud Firestore 的请求配额和限额。

测试版限额

下表显示了仅适用于测试期间的 Cloud Firestore 限额。

限额 详情
每个数据库的每秒最大写入次数(测试版) 2500(最高为每秒 2.5 MiB)
每个数据库的移动/网页客户端的最大并发连接数(测试版) 100000

免费配额

Cloud Firestore 提供了一定的免费配额,可让您免费开始使用。免费配额数量如下所示。如果您需要更多配额,则必须为 Cloud Platform 项目启用结算功能

配额按日计算,并会在美国太平洋时间零点重置。

免费方案 配额
数据存储 1 GiB
文档读取 每天 50000 次
文档写入 每天 20000 次
文档删除 每天 20000 次
网络出站流量 每月 10 GiB

标准限额

除了上面列出的测试版限额之外,您在使用 Cloud Firestore 时还要遵循标准用量限额,具体如下表所示。

集合、文档和字段

限制 详情
对于集合 ID 的限制
  • 必须是有效的 UTF-8 字符
  • 长度不能超过 1500 字节
  • 不能包含正斜杠 (/)
  • 不能只包含单个英文句点 (.) 或双重英文句点 (..)
  • 不得匹配正则表达式 __.*__
子集合的最大深度 100
对于文档 ID 的限制
  • 必须是有效的 UTF-8 字符
  • 长度不能超过 1500 字节
  • 不能包含正斜杠 (/)
  • 不能只包含单个英文句点 (.) 或双重英文句点 (..)
  • 不得匹配正则表达式 __.*__
文档名称的大小上限 6 KiB
文档的大小上限 1 MiB(1048576 字节)
对于字段名称的限制 必须是有效的 UTF-8 字符
字段名称的大小上限 1500 字节
对于字段路径的限制
  • 必须使用单个英文句点 (.) 来分隔字段名称
  • 除非字段名称满足以下要求,否则必须将每个字段名称都用反引号括起来:
    • 字段名称仅包含字符 a-zA-Z0-9 和下划线 (_)
    • 字段名称不以 0-9 开头
字段路径的大小上限 1500 字节
字段值的大小上限 1 MiB - 89 字节(1048487 字节)
map 中的字段的最大深度 20

写入和事务

限制 详情
API 请求的大小上限 10 MiB
文档的最大写入速率 每秒 1 次
其文档中某索引字段包含连续值的集合的最大写入速率 每秒 500 次
可以传递给 Commit 操作或写入交易的文档数量上限 500
事务的时间限制 270 秒,以及 60 秒的闲置状态过期时间

索引

限制 详情
一个文档的复合索引条目的大小总和上限 2 MiB
一个数据库的复合索引数量上限 200

一个文档的以下各项数量的总和上限:

  • 单字段索引条目的数量
  • 复合索引条目的数量
20000

安全规则

限制 详细信息
每次评估的唯一 exists()get()getAfter() 调用次数上限

每个调用 3 次,但这些调用的总数上限为 5 次。针对同一文档的多个请求不会计为独立的请求。

在对某个事务或批量写入中的单个或一组写入操作的规则进行评估时,针对写入目标的请求数不会计入此限额。

函数调用深度上限 20
递归或循环函数调用次数上限 0(不允许)
规则集中的表达式数量上限 10000
规则集的大小上限 64 KB

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面