すべてのプロダクト
Search

このプロダクト

    Tablestore:CreateTable

    ドキュメントセンター

    Tablestore:CreateTable

    最終更新日:Dec 28, 2024

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

    使用上の注意

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

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

    リクエスト構文

    message CreateTableRequest {
    required TableMeta table_meta = 1; // テーブルのスキーマ
    required ReservedThroughput reserved_throughput = 2; // 予約済みのスループット
    optional TableOptions table_options = 3; // テーブルオプション
    optional StreamSpecification stream_spec = 5; // ストリーム仕様
}

    パラメーター

    タイプ

    必須

    説明

    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などのテーブルパラメーター。

    stream_spec

    StreamSpecification

    いいえ

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

    レスポンス構文

    message CreateTableResponse {
}

    Tablestore SDKの使用

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