すべてのプロダクト
Search
ドキュメントセンター

Tablestore:CreateTable

最終更新日:May 08, 2025

指定されたスキーマに基づいてデータテーブルを作成します。

使用上の注意

  • データテーブルを作成した後、すぐにデータテーブルに対して読み取りおよび書き込み操作を実行することはできません。ほとんどの場合、データテーブルの作成後 1 分で、データテーブルに対して読み取りおよび書き込み操作を実行できます。

  • 1 つのインスタンスに最大 64 個のテーブルを作成できます。1 つのインスタンスにより多くのテーブルを作成する場合は、チケットを送信 してください。

リクエスト構文

message CreateTableRequest {
    required TableMeta table_meta = 1; // テーブルメタデータ
    required ReservedThroughput reserved_throughput = 2; // 予約スループット
    optional TableOptions table_options = 3; // テーブルオプション
    repeated PartitionRange partitions = 4; // パーティション範囲
    optional StreamSpecification stream_spec = 5; // ストリーム仕様
    optional SSESpecification sse_spec = 6; // SSE 仕様
    repeated IndexMeta index_metas = 7; // インデックスメタデータ
    optional bool enable_local_txn = 8; // ローカルトランザクションの有効化
}

パラメーター

必須

説明

table_meta

TableMeta

はい

データテーブルのスキーマ。次のパラメーターを構成します。

重要

データテーブルを作成した後、データテーブルのスキーマを変更することはできません。

  • table_name: データテーブルの名前。テーブル名は、インスタンス内で一意である必要があります。

  • primary_key: プライマリキーに関する情報。プライマリキーには、1 ~ 4 つのプライマリキー列を含めることができます。各プライマリキー列の名前は命名規則に準拠している必要があり、プライマリキー列のデータ型は STRING、INTEGER、または BINARY である必要があります。命名規則とデータ型の詳細については、「命名規則とデータ型」をご参照ください。

  • defined_Columns: 事前定義列に関する情報。データテーブルにセカンダリインデックスを使用する場合は、データテーブルの作成時にデータテーブルに事前定義列を追加する必要があります。事前定義列とは、特定のデータ型であらかじめ定義されているプライマリキー以外の列です。データテーブルに事前定義列を追加した後、事前定義列をインデックステーブルの属性列またはインデックスキー列として使用できます。データテーブルの作成後に、データテーブルに事前定義列を追加することもできます。詳細については、「事前定義列を使用する方法」をご参照ください。

reserved_throughput

ReservedThroughput

はい

データテーブルの予約済み読み取りまたは書き込みスループット。データテーブルの予約済み読み取りまたは書き込みスループットは 100,000 を超えることはできません。単位:容量単位(CU)

UpdateTable 操作を呼び出すことで、データテーブルの予約済み読み取りまたは書き込みスループットを変更できます。

table_options

TableOptions

いいえ

time_to_live および max_versions を含むテーブルパラメーター。

partitions

PartitionRange

いいえ

データテーブルのパーティション範囲。

stream_spec

StreamSpecification

いいえ

Stream 関連の属性を有効にするかどうかを指定します。

sse_spec

SSESpecification

いいえ

データテーブルの暗号化構成。

index_metas

IndexMeta

いいえ

インデックステーブルのスキーマ。

enable_local_txn

bool

いいえ

データテーブルのローカルトランザクション機能を有効にするかどうかを指定します。デフォルト値:false。

1 つ以上のデータ行の読み取りまたは書き込みに対してアトミック操作を実行するには、データテーブルのローカルトランザクション機能を有効にします。

レスポンス構文

message CreateTableResponse {
}

Tablestore SDK の使用

次の Tablestore SDK を使用して、指定されたスキーマに基づいてデータテーブルを作成できます。