全部產品
Search
文件中心

Tablestore:寬表模型使用限制

更新時間:Mar 14, 2025

通過本文您可以瞭解寬表模型的使用限制。

表限制

限制項

限制內容

說明

資料表名稱

執行個體內唯一

資料表命名規範如下:

  • 由英文字母、數字或底線(_)組成,大小寫敏感,長度限制為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。

屬性列個數

無限制

Table Store不限制屬性列個數。如果一次性讀取太寬的行(幾十萬個屬性列),可能會因為逾時讀取不到資料,需要指定屬性列或分頁讀取。建議將屬性列控制在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次預留讀或預留寫能力值。