宽表模型使用限制

限制项

限制内容

说明

数据表名称

实例内唯一

数据表命名规范如下：

• 由英文字母、数字或下划线（_）组成，大小写敏感，长度限制为1~255字节。

• 首字母必须为英文字母或下划线（_）。

单表的预留读写吞吐量

0~100000 CU

如果业务需求超过限制，请提交工单联系我们。

预定义列个数

0~32

预定义列是为数据表预先定义的非主键列以及其类型，可以作为二级索引的字段。如果业务需求超过限制，请提交工单联系我们。

限制项

限制内容

说明

列名限制

表内唯一

列名命名规范如下：

• 由英文字母、数字和下划线（_）组成，大小写敏感，长度限制为1~255个字节。

• 首字符必须为英文字母或下划线（_）。

主键列个数

1~4

第一个主键列为分区键。

主键列数据类型

String、Integer、Binary

• String：UTF-8编码，长度不超过1 KB。

• Integer：64位有符号整型，长度为8 Bytes。

• Binary：二进制数据，长度不超过1 KB。

属性列个数

无限制

表格存储不限制属性列个数。如果一次性读取太宽的行（几十万个属性列），可能会因为超时读取不到数据，需要指定属性列或分页读取。建议将属性列控制在10000个以内。

属性列数据类型

String、Integer、Double、Boolean、Binary

• String：UTF-8编码，长度不超过2 MB。

• Integer：64位有符号整型，长度为8 Bytes。

• Double：64位Double类型，长度为8 Bytes。

• Boolean：True或者False，布尔类型，长度为1 Byte。

• Binary：二进制数据，长度不超过2 MB。

限制项

限制内容

说明

一行中属性列的个数

无限制

无。

单行数据大小

无限制

不限制单一行中所有列名与列值的总和大小。

限制项

限制内容

说明

PutRow一次操作的数据大小

4 MB

无。

UpdateRow一次操作的数据大小

4 MB

无。

BatchWriteRow一次操作请求写入行数

200行

无。

BatchWriteRow一次操作的数据大小

4 MB

无。

BatchGetRow一次操作请求读取的行数

100行

无。

GetRange一次扫描的数据

5000行或者4 MB

一次返回的行数超过5000行或者扫描的数据量超过4 MB，满足以上任一条件，数据将会按行级别被截断并返回下一行数据主键信息。

一次请求写入的属性列的个数

1024列

使用PutRow、UpdateRow或BatchWriteRow接口操作时，单行写入的属性列的个数不能超过1024列。

读请求中columns_to_get参数的列的个数

0~128个

读请求一行数据中获取的列的最大个数。

一次HTTP请求Request Body的数据大小

5 MB

无。

一次读请求时的过滤器个数

10个

无。

表元数据操作QPS

10次/秒

一个实例的表元数据操作每秒不超过10次，关于表元数据的具体操作，请参见数据表操作。

单表UpdateTable的次数

无限制

需要遵循单表的调整频率限制。

单表UpdateTable的频率

每2分钟1次

单表在2分钟之内，最多允许调整1次预留读或预留写能力值。