使用限制
更新时间：2025-08-21
云数据库 TableStorage 产品有如下使用限制，请在开发中合理规划：
| 分类 | 数据存储模式 | 限制项 | 限制范围 | 具体说明 |
|---|---|---|---|---|
| Instance | 宽表模式 | 同一用户在同一region下可创建Instance数量上限 | 20 | 无 |
| Instance名称长度 | 3-255 Bytes | 由字母数字和下划线组成，且首字符不是数字。即规则需满足正则规范：[_a-zA-Z][\_a-za-z0-9]{0,254}。 实例名称不能包含[‘baidu’, ‘bidu’, ‘bce’, ‘bts’] 这几个单词，不能以‘__’（两个下划线）开头。 |
||
| Table | 同一Instance中最多可创建Table数量上限 | 128 | 无 | |
| Table名称长度 | 1-255 Bytes | 由字母数字和下划线组成，且首字符不是数字。即规则需满足正则规范：[_a-zA-Z][\_a-za-z0-9]{0,254}。 | ||
| 表内数据过期时间，即建表参数中的ttl | 至少23个小时 | 表内数据存活时间至少为23个小时，即82800秒。若小于23小时，则不允许建表 | ||
| 单张表UpdateTable频率 | 最多2分钟/次 | 一张表在两分钟内最多能被更新一次。 | ||
| Row | 每一行的主键（Rowkey）包含的列数量 | 1 | 云数据库 TableStorage 后续版本会支持更多数量的主键列数 | |
| 主键（Rowkey）列值大小 | 1-4096 Bytes | 主键列值用于唯一标识行，填写后不可修改，行健值中建议不要有空格、换行符等不可见字符，以免造成查询上的不便。 | ||
| 每一行的属性列数量 | 无限制 | 云数据库 TableStorage 对于属性列数量并无限制，但单行大小受限于8MB，并且随着属性列的增加性能会有所下降，为获得最佳性能，推荐列个数在300以内 | ||
| 属性列名称长度 | 1-255 Bytes | 由字母数字和下划线组成，且首字符不是数字，规则需满足正则规范：[_a-zA-Z][\_a-za-z0-9]{0,254}。 | ||
| 属性列值大小 | 0-2MB | 云数据库 TableStorage 暂时只支持String/Binary类型列，大小为2MB（包含）以内。 | ||
| 单行数据大小 | 0-8MB | 控制台只能展示解压后8M内前50行数据的前20列，8MB即8,388,608字节。 | ||
| 一次写入的每行属性列个数 | 1024列 | PutRow、BatchPutRow时，单次请求每行写入列必需小于或等于1024列。 DeleteRow、BatchDeleteRow时，如果指定删除某些列时，每行指定的列数（cells中column数量）不能超过1024列。 如果删除时不指定列，指删除整行，不受此限制。 |
||
| 一次读请求指定的属性列个数 | 128列 | GetRow、BatchGetRow时指定的列数（cells中column数量），Scan时指定的列数（selector中column数量），均不能超过128列。 如果不指定，即读取整行时，不受此限制。 |
||
| BatchPutRow/BatchDeleteRow时一次写入的行数 | 200行 | 无 | ||
| BatchGetRow时一次读取的行数 | 100行 | 无 | ||
| 单次Scan操作返回数据 | 0-8MB或者10000行 | 一次Scan请求最多返回不大于8MB（包含）或不多于10000行（包含）的数据。满足两个条件任意一个时，超出的数据将会按行截断并返回下一行主键信息nextStartKey | ||
| 一次http请求request body上限 | 0-10MB | 所有请求的body大小不能超过10MB（包含） | ||
| database | 时序模式 | 数量 | 同region下数量上限20 | 无 |
| database name | 3-255 Bytes | 由字母数字和下划线组成，且首字符不是数字。即规则需满足正则规范：[_a-zA-Z][\_a-za-z0-9]{0,254}。 实例名称不能包含[‘baidu’, ‘bidu’, ‘bce’, ‘bts’] 这几个单词，不能以‘__’（两个下划线）开头。 |
||
| bucket | 数量 | 128 | 无 | |
| bucket name | 1-255 Bytes | 由字母数字和下划线组成，且首字符不是数字。即规则需满足正则规范：[_a-zA-Z][\_a-za-z0-9]{0,254}。 | ||
| retentionRules：everySeconds | 至少23小时 | 表内数据存活时间至少为23个小时，即82800秒。若小于23小时，则不允许创建bucket。 | ||
| measurement | measurement | 255 Bytes | 一个时间序列只能有1个度量名称，不能以下划线和数字开头，不允许包含非ASCII字符。 | |
| tag | tag key | 255 Bytes | 一个时间序列只能有1个标签。标签健不能以下划线和数字开头，不允许包含非ASCII字符；标签值不允许包含非ASCII字符。 | |
| tag value | 无限制 | measurement+tag key+tag value + field key + timestamp的长度为上限为 4096 Bytes。 | ||
| field | field key | 255 Bytes | 不能以下划线和数字开头，不允许包含非ASCII字符。 | |
| tag value | 无限制 | 支持String/Float/Int/Uint/Boolean类型。 | ||
| point | 单次写入数量 | 200 | 单次写入在200个Point以内，控制台一次只能写入20列 | |
| 读取时返回数据point数量 | 8MB 10000个Point |
一次读取数据返回数据解压后不超过8MB 且 不超过10000(包含)个Point。 控制台只能展示解压后8M内前50行数据的前20列，8MB即8,388,608字节。 |
||
| 单次http请求的body上限 | 10MB | 所有请求的body大小不超过10MB(包含) | ||
| 读取时间范围限制 | < 3个月 | time range不能超过3个月，用户需要自行改time range； 如果用户不显示指定time range，则默认读取最近1个月的数据； |