すべてのプロダクト
Search

このプロダクト

    Tablestore:ワイドカラムモデルの制限事項

    ドキュメントセンター

    Tablestore:ワイドカラムモデルの制限事項

    最終更新日:May 09, 2026

    このトピックでは、ワイドカラムモデルの制限事項について説明します。

    テーブル制限

    項目

    制限

    説明

    データテーブル名

    インスタンス内で一意

    データテーブルには、以下の命名規則が適用されます。

    • 名前の長さは 1～255 バイトで、英字、数字、アンダースコア (_) を使用でき、大文字と小文字は区別されます。

    • 最初の文字は英字またはアンダースコア (_) である必要があります。

    単一テーブルの予約済みの読み取り/書き込みスループット

    0～100,000 CU

    より高い制限が必要な場合は、テクニカルサポートに連絡するか、DingTalk グループにご参加ください：36165029092。

    事前定義列の数

    0～32

    事前定義列とは、名前とデータの型が定義されたプライマリキー以外の列です。セカンダリインデックスのインデックスフィールドとして使用できます。

    より高い制限が必要な場合は、テクニカルサポートに連絡するか、DingTalk グループにご参加ください：36165029092。

    カラム制限

    項目

    制限

    説明

    カラム名

    テーブル内で一意

    カラムには、以下の命名規則が適用されます。

    • 名前の長さは 1～255 バイトで、英字、数字、アンダースコア (_) を使用でき、大文字と小文字は区別されます。

    • 最初の文字は英字またはアンダースコア (_) である必要があります。

    プライマリキー列の数

    1～4

    最初のプライマリキー列はパーティションキーです。

    プライマリキー列のデータの型

    文字列、整数、バイナリ

    • 文字列：UTF-8 エンコードの文字列で、最大長は 1 KB です。

    • 整数：8 バイト長の 64 ビット符号付き整数です。

    • バイナリ：最大長 1 KB のバイナリデータです。

    属性列の数

    無制限

    Tablestore では属性列の数に制限はありませんが、非常に幅の広い行を読み取るとリクエストがタイムアウトする可能性があります。これを回避するには、読み取るカラムを指定するか、結果をページネーションしてください。1 行あたりの属性列は 10,000 未満にすることを推奨します。

    属性列のデータの型

    文字列、整数、Double、ブール値、バイナリ

    • 文字列：UTF-8 エンコードの文字列で、最大長は 2 MB です。

    • 整数：8 バイト長の 64 ビット符号付き整数です。

    • Double：8 バイト長の 64 ビット倍精度浮動小数点数です。

    • ブール値：True または False のブール値で、1 バイト長です。

    • バイナリ：最大長 2 MB のバイナリデータです。

    説明

    これらのサイズ制限は、属性列の各バージョン個別に適用されます。複数バージョンの累積サイズや、1 行内の全カラムの合計サイズには適用されません。

    行制限

    項目

    制限

    説明

    1 行あたりの属性列の数

    無制限

    1 行内の属性列の数に制限はありません。

    1 行あたりのデータサイズ

    無制限

    1 行の合計データサイズに制限はありません。

    操作制限

    項目

    制限

    説明

    PutRow リクエストあたりのデータサイズ

    4 MB

    この制限は、1 回のリクエストにおけるプライマリキーおよび属性列の合計サイズに適用されます。

    UpdateRow リクエストあたりのデータサイズ

    4 MB

    この制限は、1 回のリクエストにおけるプライマリキーおよび属性列の合計サイズに適用されます。

    BatchWriteRow リクエストあたりの行数

    200

    これは、1 回の BatchWriteRow リクエストで処理できる最大行数です。

    BatchWriteRow リクエストあたりのデータサイズ

    4 MB

    この制限は、1 回の BatchWriteRow リクエストにおけるすべての行の合計データサイズに適用されます。

    BatchGetRow リクエストあたりの行数

    100

    これは、1 回の BatchGetRow リクエストで取得できる最大行数です。

    GetRange リクエストあたりのスキャンデータ量

    5,000 行または 4 MB

    スキャンは、5,000 行がスキャンされた時点、またはデータサイズが 4 MB に達した時点で停止します。次の行のプライマリキーが返され、ページネーションが可能になります。

    1 回の書き込みリクエストあたりの属性列の数

    1,024

    1 回の PutRow、UpdateRow、または BatchWriteRow 操作では、1 行に対して 1,024 個を超える属性列を書き込むことはできません。

    columns_to_get パラメーター内のカラム数

    0～128

    1 回の読み取りリクエストで 1 行から取得できるカラムの最大数を指定します。

    HTTP リクエストボディのサイズ

    5 MB

    これはリクエストボディの最大サイズです。

    読み取りリクエストあたりのフィルター数

    10

    これは 1 回の読み取りリクエストで許可される最大数です。

    テーブルメタデータ操作の QPS

    1 秒あたり 10

    1 つのインスタンスにおけるすべてのテーブルメタデータ操作の合計 QPS は 10 を超えることができません。詳細については、「データテーブル操作」をご参照ください。

    単一テーブルに対する UpdateTable 操作の呼び出し回数

    無制限

    呼び出し回数に制限はありませんが、以下に示す頻度制限の影響を受けます。

    単一テーブルに対する UpdateTable 操作の頻度

    2 分に 1 回

    テーブルの予約済みの読み取り/書き込みスループットは、2 分に 1 回までしか調整できません。