本页面介绍了 Spanner 在生产环境中的配额和限制。在 Google Cloud 控制台中，配额和限制可以互换使用。
配额和限制值随时可能更改。
查看和修改配额的权限
如需查看您的配额，您必须拥有 serviceusage.quotas.get Identity and Access Management (IAM) 权限。
如需更改配额，您必须拥有 serviceusage.quotas.update IAM 权限。默认情况下，以下预定义角色包含此权限：Owner、Editor 和 Quota Administrator。
默认情况下，这些权限包含在基本 IAM 角色 Owner 和 Editor 以及预定义的配额管理员角色中。
查看您的配额
如需查看您项目中资源的当前配额，请使用 Google Cloud 控制台：
增加您的配额
随着您的 Spanner 使用量逐步增加，您的配额可以相应增加。如果您预计自己的用量即将显著增加，则应提前几天提出申请，以确保您的配额充足。
您可能还需要提高使用方配额覆盖值。如需了解详情，请参阅创建使用方配额覆盖。
您可以使用 Google Cloud 控制台提高当前的 Spanner 实例配置节点限制。
转到配额页面。
从服务下拉列表中选择 Spanner API。
如果找不到 Spanner API，则表示 Spanner API 尚未启用。如需了解详情，请参阅启用 API。
选择要更改的配额。
点击修改配额。
在显示的配额更改面板中，输入新的配额上限。
点击完成，然后点击提交请求。
如果您无法手动将节点数上限提高到所需上限，请点击申请更高配额。填写表单，向 Spanner 团队提交请求。您将在提交申请后的 48 小时内收到回复。
增加自定义实例配置的配额
您可以增加自定义实例配置的节点配额。
通过检查基本实例配置的节点限制，检查自定义实例配置的节点限制。
如果您不知道或忘记自定义实例配置的基本配置，请使用显示实例配置详情命令。
如果自定义实例配置所需的节点数上限低于 85，请按照上文增加配额部分中的说明操作。使用 Google Cloud 控制台提高与自定义实例配置关联的基本实例配置的节点限制。
如果自定义实例配置所需的节点数上限超过 85，请填写请求增加 Spanner 节点的配额表单。在表单中指定自定义实例配置的 ID。
节点限制
| 值 | 限制 |
|---|---|
| 每个实例配置的节点数 |
默认限额因项目和实例配置而异。如需更改项目配额限制或申请增加限额，请参阅增加配额。 |
实例限制
| 值 | 限制 |
|---|---|
| 实例 ID 长度 | 2 到 64 个字符 |
免费试用实例限制
Spanner 免费试用实例具有以下额外限制。如需提高或移除这些限制，请将免费试用实例升级为付费实例。
| 值 | 限制 |
|---|---|
| 存储空间容量 | 10 GB |
| 数据库限制 | 最多创建 5 个数据库 |
| 不受支持的功能 | 备份和恢复 |
| 服务等级协议 | 无服务等级协议 (SLA) 保证 |
| 试用期 | 90 天免费试用期 |
实例配置限制
| 值 | 限制 |
|---|---|
| 每个项目的自定义实例配置数量上限 | 100 |
| 自定义实例配置 ID 长度 | 8 到 64 个字符 自定义实例配置 ID 必须以 |
数据库限制
| 值 | 限制 |
|---|---|
| 每个实例的数据库数 |
|
| 每个数据库的角色 | 100 |
| 数据库 ID 长度 | 2 到 30 个字符 |
| 存储空间使用量1 |
在部分单区域和多区域 Spanner 实例配置中，每个节点的存储容量增加 10 TB。如需了解详情，请参阅性能和存储空间改进。 备份会单独存储，不计入此限额。如需了解详情，请参阅存储空间利用率指标。 请注意，Spanner 会按实例内使用的实际存储空间（而不是其总可用存储空间）计费。 |
备份和恢复限制
| 值 | 限制 |
|---|---|
| 每个数据库正在进行的“创建备份”操作数 | 1 |
| 每个实例正在进行的“恢复数据库”操作数（在恢复的数据库实例中，而不是在备份中） | 10 |
| 备份的最长保留时间 | 1 年（包括闰年多出的一天） |
架构限制
DDL 语句
| 值 | 限制 |
|---|---|
| 单个架构更改的 DDL 语句大小 | 10 MB |
数据库整个架构的 DDL 语句大小（由 GetDatabaseDdl 返回） |
10 MB |
表
| 值 | 限制 |
|---|---|
| 每个数据库的表数 | 5,000 |
| 表名称长度 | 1 到 128 个字符 |
| 每个表的列数 | 1024 |
| 列名称长度 | 1 到 128 个字符 |
| 每个单元格的数据大小 | 10 MB |
| 表键中的列数 | 16 包括与任何父表共享的键列 |
| 表交错深度 | 7 包含子表的顶层表的深度为 1。 包含孙表的顶层表的深度为 2，以此类推。 |
| 表键或索引键的总大小 | 8 KB 包括构成相应键的所有列的大小 |
| 非键列的总大小 | 1600 MB 包括表中所有非键列的大小 |
索引
| 值 | 限制 |
|---|---|
| 每个数据库的索引数 | 1 万 |
| 每个表的索引数 | 128 |
| 索引名称长度 | 1 到 128 个字符 |
| 索引键中的列数 | 16 编入索引的列的数量（STORING 列除外）加上基表中主键列的数量 |
视图
| 值 | 限制 |
|---|---|
| 每个数据库的视图数 | 5,000 |
| 视图名称长度 | 1 到 128 个字符 |
| 嵌套深度 | 10 对于引用其他视图的视图，其嵌套深度为 1。对于引用其他视图并且该视图又引用另外视图的视图，其嵌套深度为 2，以此类推。 |
查询限制
| 值 | 限制 |
|---|---|
一个 GROUP BY 子句中的列数 |
1,000 |
IN 运算符中的值 |
10,000 |
| 函数调用次数 | 1,000 |
| 联接数 | 20 |
| 嵌套函数调用次数 | 75 |
嵌套 GROUP BY 子句数量 |
35 |
| 嵌套子查询表达式数量 | 25 |
| 嵌套子选择语句数 | 60 |
| 参数 | 950 |
| 查询语句长度 | 1 百万个字符 |
STRUCT 个字段 |
1,000 |
| 子查询表达式子项数 | 50 |
| 查询中的 union 数 | 200 |
创建、读取、更新和删除数据的限制
| 值 | 限制 |
|---|---|
| 提交大小（包括索引和变更数据流） | 100 MB |
| 每个会话的并发读取数 | 100 |
| 每次提交包含的更改数（包括索引）2 | 80000 |
| 每个数据库的并发分区 DML 语句数 | 20000 |
管理限制
| 值 | 限制 |
|---|---|
| 管理操作的请求大小3 | 1 MB |
| 管理操作的速率限制4 | 每位用户每个项目每秒 5 次 （按 100 秒计算得到的平均值） |
请求限制
| 值 | 限制 |
|---|---|
| 请求大小（提交除外）5 | 10 MB |
变更数据流限制
| 值 | 限制 |
|---|---|
| 每个数据库的变更数据流 | 10 |
| 监控任何给定非键列的变更数据流6 | 3 |
| 每个变更数据流数据分区的并发读取器数量7 | 5 |
流量提升限制
| 值 | 限制 |
|---|---|
| 并发 Data Boost 请求8 | 200 |
Notes
1. 为了保证数据库访问的高可用性和低延迟，Spanner 根据实例的计算容量定义了存储限制：
- 对于少于 1 个节点（1,000 个处理单元）的实例，Spanner 为数据库中的每 100 个处理单元分配 409.6 GB 的数据。
- 对于具有 1 个及更多节点的实例，Spanner 会为每个节点分配 4 TB 的数据。
例如，如需为 600 GB 的数据库创建实例，您需要将其计算容量设置为 200 个处理单元。在数据库扩容到超过 819.2 GB 之前，此计算容量将使实例保持在限制范围内。当数据库达到此大小后，您需要再添加 100 个处理单元，才能让数据库继续增长。否则，对数据库执行的写入操作可能会被拒绝。如需了解详情，请参阅数据库存储空间利用率建议。
为了获得平稳的增长体验，请在数据库容量达到上限之前增加计算容量。
2. 在为插入和更新操作计算更改数时，需要乘以受影响的列数，且主键列始终会受影响。例如，如果向五个列中插入值，则插入一条新记录的操作会被计为五项更改。如果记录具有两个主键列，则更新该记录中的三列也可能会被计为五项变更。无论受影响的列有多少个，删除操作和删除某个范围的操作都计为一项更改。无论交错式子行有多少个，从具有 ON DELETE
CASCADE 注解的父表中删除一行也计为一项更改。有一个例外，如果对要删除的行定义了二级索引，系统将单独计算二级索引的更改。例如，如果某个表有 2 个二级索引，那么删除表中的一系列行将计为该表的 1 项变更，加上每一行的 2 项变更，这是因为二级索引中的行可能分散在键空间内，使得 Spanner 无法对二级索引调用单个删除范围操作。二级索引包含外键和支持性索引。
如需查找事务的变更计数，请参阅检索事务的提交统计信息。
变更数据流不会添加任何计入此限制的变更。
3. 针对管理操作请求的限制不适用于提交、备注 5 中列出的请求和架构更改。
4.此速率限制适用于对 Admin API 的所有调用，其中包括对针对实例、数据库或备份的长时间运行的操作进行轮询的调用。
5. 此限制适用于以下操作请求：创建数据库、更新数据库、读取、流式读取、执行 SQL 查询以及执行流式 SQL 查询。
6. 监控整个表或数据库的变更数据流会隐式监控该表或数据库中的每个列，因此会计入此限额。
7. 此限制适用于同一变更数据流分区的并发读取器，无论这些读取器是 Dataflow 流水线还是直接 API 查询。
8. 默认限额因项目和区域而异。如需了解详情，请参阅监控和管理 Data Boost 配额用量。