使用限制

更新时间：2024-10-11

云数据库 TableStorage 产品有如下使用限制，请在开发中合理规划：

分类	数据存储模式	限制项	限制范围	具体说明
Instance	宽表模式	同一用户在同一region下可创建Instance数量上限	20	无
Instance		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		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		tag value	无限制	measurement+tag key+tag value + field key + timestamp的长度为上限为 4096 Bytes。
field		field key	255 Bytes	不能以下划线和数字开头，不允许包含非ASCII字符。
field		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个月的数据；

应用场景

产品定价