全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::OTS::Table

更新时间:Jun 26, 2025

ALIYUN::OTS::Table digunakan untuk membuat tabel berdasarkan skema yang telah ditentukan.

Sintaksis

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

Properti

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
ReservedThroughputMapTidakYaPengaturan throughput baca/tulis cadangan awal tabel.Throughput baca/tulis cadangan tabel tidak boleh melebihi 5.000 per detik.

Untuk informasi lebih lanjut, lihat Properti ReservedThroughput.

MaxVersionsIntegerTidakYaJumlah maksimum versi data yang dapat disimpan di tabel.Nilai valid: 1 hingga 2147483647.

Nilai default: 1.

TableNameStringYaTidakNama tabel.Tidak ada
SecondaryIndicesListTidakTidakDaftar satu atau lebih indeks sekunder dari tabel.Untuk informasi lebih lanjut, lihat Properti SecondaryIndices.
DeviationCellVersionInSecIntegerTidakYaOffset versi maksimum antara nomor versi kustom dan timestamp sistem saat ini.Parameter ini digunakan untuk mencegah pengguna menulis data dengan nomor versi kustom di luar rentang versi yang valid. Sebagai contoh, jika timestamp sistem saat ini adalah 10000 dan parameter DeviationCellVersionInSec diatur ke 1000, rentang versi yang valid adalah [10000 - 1000, 10000 + 1000).

Nilai valid: 1 hingga 9223372036854775807.

Nilai default: 86400.

TimeToLiveIntegerTidakYaPeriode penyimpanan data di tabel.

Nilai maksimum: 2147483647.

Nilai default: 1.

Satuan: detik.

Nilai -1 menunjukkan bahwa data tidak pernah kedaluwarsa.

InstanceNameStringYaTidakNama instance tempat tabel berada.Tidak ada
PrimaryKeyListYaTidakSemua kolom kunci utama tabel.Nilai valid: 1 hingga 4.

Untuk informasi lebih lanjut, lihat Properti PrimaryKey.

ColumnsListTidakTidakDaftar satu atau lebih kolom atribut tabel.Untuk informasi lebih lanjut, lihat Properti Columns.

Sintaksis ReservedThroughput

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

Properti ReservedThroughput

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
ReadIntegerYaYaJumlah CU baca yang dikonsumsi atau throughput baca cadangan tabel.Nilai default: 0.
WriteIntegerYaYaJumlah CU tulis yang dikonsumsi atau throughput tulis cadangan tabel.Nilai default: 0.

Sintaksis SecondaryIndices

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

Properti SecondaryIndices

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
IndexNameStringYaTidakNama indeks.Tidak ada
IndexTypeStringTidakTidakTipe indeks.Nilai valid:
  • Global
  • Local
ColumnsListYaTidakDaftar satu atau lebih kolom indeks.Contoh:
["name", "email"]
Catatan Properti parameter ini berbeda dari Properti Columns, yang menunjukkan daftar satu atau lebih kolom atribut tabel.
PrimaryKeysListYaTidakDaftar satu atau lebih kunci utama indeks.Tidak ada

Sintaksis PrimaryKey

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

Properti PrimaryKey

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
TypeStringYaTidakTipe kunci utama.Nilai valid:
  • INTEGER
  • STRING
  • BINARY
NameStringYaTidakNama kunci utama.Tidak ada

Sintaksis Columns

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

Properti Columns

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
TypeStringYaTidakTipe kolom.Tidak ada
NameStringYaTidakNama kolom.Tidak ada

Parameter respons

Fn::GetAtt

TableName: Nama tabel.

Contoh

  • Format YAML.

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

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