更新时间:2026-05-20 GMT+08:00
数据库使用约束规范
强制类约束
规则约束
- 当使用不当,数值超出约定的告警阈值后,客户端会收到Warn,并且云监控服务(CES)会产生告警信息;部分请求会产生事件信息。
- 当使用严重违反约束,数值超出约定的失败阈值后,请求会失败,并且产生事件信息。
约束项
- 单行大小限制:
- 当读取数据时,数据库会将同一个Primary Key的多次写入合并成一行,当单行的数据超出阈值后会产生告警和事件。
- 单个分区限制:
- 数据库后台扫描任务会定期统计Partition个数,Partition内行数,Partition内所有行的大小总和,当单行的数据超出阈值后会产生告警和事件。
- 集合类型元素个数限制:
- 当读取数据时,需要读取复杂列类型(Map,List,Set,Tuple等)的数据时,数据库会对复杂列的元素个数进行统计,当个数超出阈值后会产生告警和事件。
- 查询返回数据量限制:
- 查询Response返回给客户端前,数据库会对查询Response的数据量进行校验,当超出阈值后会产生告警或请求失败。
- 查询返回的墓碑数限制:
- 当查询数据扫描到存在过多墓碑时,数据库会对墓碑数进行校验,当超出阈值后会产生告警或请求失败。
| 约束项 | 告警阈值 | 失败阈值 |
|---|---|---|
| 单行大小限制 | 100KB | - |
| 单个分区限制 |
| - |
| 集合类型元素个数限制 | 500 | - |
| 查询返回数据量限制 | 2MB | 100MB |
| 查询返回的墓碑数限制 | 1,000 | 100,000 |