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

Resource Orchestration Service:ALIYUN::OTS::Table

最終更新日:Jan 16, 2025

ALIYUN::OTS::Table は、指定されたスキーマに基づいてテーブルを作成するために使用されます。

構文

{
  "Type": "ALIYUN::OTS::Table",
  "Properties": {
    "ReservedThroughput": Map,
    "MaxVersions": Integer,
    "TableName": String,
    "SecondaryIndices": List,
    "DeviationCellVersionInSec": Integer,
    "TimeToLive": Integer,
    "InstanceName": String,
    "PrimaryKey": List,
    "Columns": List
  }
}

プロパティ

プロパティタイプ必須編集可能説明制約
ReservedThroughputMapいいえはいテーブルの初期予約読み取り/書き込みスループット設定。テーブルの予約読み取り/書き込みスループットは、1 秒あたり 5,000 を超えることはできません。

詳細については、ReservedThroughput プロパティをご参照ください。

MaxVersionsIntegerいいえはいテーブルに保持できるデータバージョンの最大数。有効な値:1 ~ 2147483647。

デフォルト値:1。

TableNameStringはいいいえテーブルの名前。なし
SecondaryIndicesListいいえいいえテーブルの 1 つ以上のセカンダリインデックスのリスト。詳細については、SecondaryIndices プロパティをご参照ください。
DeviationCellVersionInSecIntegerいいえはいカスタムバージョン番号と現在のシステムタイムスタンプ間の最大バージョンオフセット。このパラメータは、有効なバージョン範囲を超えたカスタムバージョン番号を持つデータがユーザーによって書き込まれるのを防ぐために使用されます。たとえば、現在のシステムタイムスタンプが 10000 で、DeviationCellVersionInSec パラメータが 1000 に設定されている場合、有効なバージョン範囲は [10000 - 1000, 10000 + 1000) です。

有効な値:1 ~ 9223372036854775807。

デフォルト値:86400。

TimeToLiveIntegerいいえはいテーブルに格納されているデータの保存期間。

最大値:2147483647。

デフォルト値:1。

単位:秒。

-1 の値は、データが期限切れにならないことを示します。

InstanceNameStringはいいいえテーブルが存在するインスタンスの名前。なし
PrimaryKeyListはいいいえテーブルのすべてのプライマリキー列。有効な値:1 ~ 4。

詳細については、PrimaryKey プロパティをご参照ください。

ColumnsListいいえいいえテーブルの 1 つ以上の属性列のリスト。詳細については、Columns プロパティをご参照ください。

ReservedThroughput 構文

"ReservedThroughput": {
  "Read": Integer,
  "Write": Integer
}

ReservedThroughput プロパティ

プロパティタイプ必須編集可能説明制約
ReadIntegerはいはい消費される読み取り CU の数、またはテーブルの予約読み取りスループット。デフォルト値:0。
WriteIntegerはいはい消費される書き込み CU の数、またはテーブルの予約書き込みスループット。デフォルト値:0。

SecondaryIndices 構文

"SecondaryIndices": [
  {
    "IndexName": String,
    "IndexType": String,
    "Columns": List,
    "PrimaryKeys": List
  }
]

SecondaryIndices プロパティ

プロパティタイプ必須編集可能説明制約
IndexNameStringはいいいえインデックスの名前。なし
IndexTypeStringいいえいいえインデックスのタイプ。有効な値:
  • Global
  • Local
ColumnsListはいいいえインデックスの 1 つ以上の列のリスト。例:
["name", "email"]
説明 このパラメータのプロパティは、テーブルの 1 つ以上の属性列のリストを示す Columns プロパティとは異なります。
PrimaryKeysListはいいいえインデックスの 1 つ以上のプライマリキーのリスト。なし

PrimaryKey 構文

"PrimaryKey": [
  {
    "Type": String,
    "Name": String
  }
]

PrimaryKey プロパティ

プロパティタイプ必須編集可能説明制約
TypeStringはいいいえプライマリキーのタイプ。有効な値:
  • INTEGER
  • STRING
  • BINARY
NameStringはいいいえプライマリキーの名前。なし

Columns 構文

"Columns": [
  {
    "Type": String,
    "Name": String
  }
]

Columns プロパティ

プロパティタイプ必須編集可能説明制約
TypeStringはいいいえ列のタイプ。なし
NameStringはいいいえ列の名前。なし

レスポンスパラメータ

Fn::GetAtt

TableName: テーブルの名前。

  • YAML 形式

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters: {}
    Resources:
      Table:
        Type: ALIYUN::OTS::Table
        Properties:
          TableName: TestTable
          InstanceName: mytest
          PrimaryKey:
            - Type: INTEGER
              Name: id
  • JSON 形式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
      },
      "Resources": {
        "Table": {
          "Type": "ALIYUN::OTS::Table",
          "Properties": {
            "TableName": "TestTable",
            "InstanceName": "mytest",
            "PrimaryKey": [
              {
                "Type": "INTEGER",
                "Name": "id"
              }
            ]
          }
        }
      }
    }