UpdateTable - Amazon DynamoDB

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

UpdateTable

penting

This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.

Untuk dokumentasi tentang API tingkat rendah saat ini, lihat Referensi API Amazon DynamoDB.

Deskripsi

Memperbarui throughput yang disediakan untuk tabel yang ditentukan. Mengatur throughput untuk tabel membantu Anda mengelola performa dan merupakan bagian dari fitur throughput yang disediakan dalam DynamoDB. Untuk informasi selengkapnya, lihat Mode kapasitas yang disediakan DynamoDB.

Nilai throughput yang disediakan dapat ditingkatkan atau diturunkan berdasarkan nilai maksimum dan minimum yang tercantum dalam Kuota di Amazon DynamoDB.

Tabel harus dalam ACTIVE keadaan agar operasi ini berhasil. UpdateTable adalah operasi asinkron; saat menjalankan operasi, tabel dalam keadaan. UPDATING Meskipun berada dalam status UPDATING, tabel masih memiliki throughput yang disediakan sejak sebelum panggilan. Pengaturan throughput baru yang disediakan hanya berlaku ketika tabel kembali ke ACTIVE status setelah operasi. UpdateTable

Permintaan

Sintaks

// This header is abbreviated. // For a sample of a complete header, see API tingkat rendah DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
Nama Deskripsi Wajib
TableName

Nama tabel yang akan diperbarui.

Jenis: String

Ya
ProvisionedThroughput

Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Lihat Mode kapasitas yang disediakan DynamoDB.

Jenis: Array

Ya
ProvisionedThroughput :ReadCapacityUnits

Menetapkan jumlah minimum ReadCapacityUnits yang konsisten digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.

Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 ReadCapacityUnits yang konsisten per detik akan menghasilkan 100 ReadCapacityUnits akhir konsisten per detik.

Jenis: Angka

Ya
ProvisionedThroughput :WriteCapacityUnits

Menetapkan jumlah minimum WriteCapacityUnits yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.

Jenis: Angka

Ya

Respons

Sintaks

HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG Content-Type: application/json Content-Length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"UPDATING"}}
Nama Deskripsi
CreationDateTime

Tanggal ketika tabel dibuat.

Jenis: Angka

KeySchema

Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk HashKeyElement diperlukan, dan pasangan nama-nilai untuk RangeKeyElement bersifat opsional (hanya diperlukan untuk kunci primer komposit). Ukuran kunci hash maksimum adalah 2048 byte. Ukuran kunci rentang maksimum adalah 1024 byte. Kedua batas tersebut diberlakukan secara terpisah (yaitu Anda dapat memiliki kombinasi hash + rentang 2048 + 1024 kunci). Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer.

Jenis: Peta HashKeyElement, atau HashKeyElement dan RangeKeyElement untuk kunci primer komposit.

ProvisionedThroughput

Pengaturan throughput saat ini untuk tabel yang ditentukan, termasuk nilai untuk LastIncreaseDateTime (jika berlaku), LastDecreaseDateTime (jika berlaku),

Jenis: Array

TableName

Nama tabel yang diperbarui.

Jenis: String

TableStatus Status tabel saat ini (CREATING, ACTIVE, DELETING, atau UPDATING), yang seharusnya UPDATING.

Gunakan operasi DescribeTables untuk memeriksa status tabel.

Jenis: String

Kesalahan khusus

Kesalahan Deskripsi
ResourceNotFoundException Tabel yang ditentukan tidak ditemukan.
ResourceInUseException Tabel ini tidak berada dalam status ACTIVE.

Contoh

Permintaan sampel

// This header is abbreviated. // For a sample of a complete header, see API tingkat rendah DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"comp1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }

Respons sampel

HTTP/1.1 200 OK content-type: application/x-amz-json-1.0 content-length: 390 Date: Sat, 19 Nov 2011 00:46:47 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"comp1", "TableStatus":"UPDATING"} }