全部产品
Search

搜索本产品

    Tablestore：UpdateTable

    文档中心

    Tablestore：UpdateTable

    更新时间：Jul 06, 2025

    Gunakan operasi UpdateTable untuk memodifikasi informasi konfigurasi yang ditentukan oleh parameter table_options, konfigurasi Stream yang ditentukan oleh parameter StreamSpecification, serta throughput baca atau tulis yang dicadangkan yang ditentukan oleh parameter reserved_throughput untuk tabel data. Jika tabel berada dalam instance performa tinggi, pembaruan throughput baca atau tulis yang dicadangkan akan berlaku dalam waktu 1 menit setelah pembaruan berhasil.

    Sintaks permintaan

    message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}

    Parameter

    Tipe

    Diperlukan

    Deskripsi

    table_name

    string

    Ya

    Nama tabel data yang ingin Anda modifikasi throughput baca atau tulis yang dicadangkan.

    reserved_throughput

    ReservedThroughput

    Tidak

    Throughput baca atau tulis yang dicadangkan baru untuk tabel data. Throughput baca atau tulis yang dicadangkan baru akan berlaku dalam waktu 1 menit setelah pembaruan berhasil.

    Anda harus menentukan nilai non-null untuk throughput baca atau tulis yang dicadangkan menggunakan parameter capacity_unit. Jika tidak, permintaan akan gagal dan kesalahan akan dikembalikan.

    table_options

    TableOptions

    Tidak

    Pengaturan time to live (TTL) dan max versions.

    StreamSpecification

    StreamSpecification

    Tidak

    Informasi Stream tentang tabel data, termasuk apakah fitur Stream diaktifkan dan periode validitas log.

    Sintaks respons

    message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
    optional StreamDetails stream_details = 3;
}

    Parameter

    Tipe

    Deskripsi

    capacity_unit_details

    ReservedThroughputDetails

    Pengaturan throughput baca atau tulis yang dicadangkan dari tabel data setelah pembaruan berhasil. Pengaturan ini mencakup nilai throughput baca atau tulis yang dicadangkan terbaru, waktu ketika nilai throughput baca atau tulis yang dicadangkan terakhir diperbarui, dan jumlah kali nilai throughput baca atau tulis yang dicadangkan diturunkan pada hari itu.

    Catatan

    • Interval minimum untuk memperbarui throughput baca atau tulis yang dicadangkan dari tabel data adalah 2 menit. Jika Anda memanggil operasi UpdateTable lagi dalam waktu 2 menit setelah panggilan sebelumnya, operasi tersebut akan gagal.

    • Throughput baca atau tulis yang dicadangkan dari tabel data dapat dinaikkan atau diturunkan tanpa batas dalam satu hari (dari 00:00:00 hingga 00:00:00 keesokan harinya dalam waktu UTC).

    table_options

    TableOptions

    Nilai terbaru dari parameter table_options setelah pembaruan.

    stream_details

    StreamDetails

    Informasi Stream tentang tabel data, termasuk apakah fitur Stream diaktifkan untuk tabel data, periode validitas log, dan waktu terakhir fitur Stream diaktifkan.

    Gunakan SDK Tablestore

    Anda dapat menggunakan SDK Tablestore berikut untuk memperbarui tabel: