全部产品
Search
文档中心

Tablestore:Memperbarui konfigurasi tabel

更新时间:Aug 13, 2025

Topik ini menjelaskan cara memperbarui konfigurasi tabel menggunakan Tablestore SDK untuk Node.js.

Prasyarat

Inisialisasi klien Tablestore.

Deskripsi metode

updateTable: function describeTable(params, callback) 

Deskripsi Parameter params

  • tableName (wajib) string: Nama tabel data.

  • tableOptions (wajib) object: Informasi konfigurasi tabel, mencakup parameter berikut.

    Parameter

    Tipe

    Deskripsi

    timeToLive (opsional)

    number

    Masa hidup data (TTL) dalam tabel deret waktu. Unit: detik.

    • Jika Anda mengatur nilainya ke -1, data tidak pernah kedaluwarsa. Jika tidak, nilai minimumnya adalah 86400 (satu hari). Data yang melebihi TTL secara otomatis dihapus.

    • Untuk menggunakan fitur indeks pencarian atau indeks sekunder, Anda harus mengatur TTL ke -1 atau menetapkan allowUpdate menjadi false.

    maxVersions (opsional)

    number

    Jumlah maksimum versi.

    Untuk menggunakan fitur indeks pencarian atau indeks sekunder, Anda harus mengatur jumlah maksimum versi menjadi 1.

    maxTimeDeviation (opsional)

    number

    Offset versi maksimum. Unit: detik.

    • Selisih antara timestamp data yang ditulis dan waktu sistem saat ini harus berada dalam rentang offset versi maksimum. Jika tidak, penulisan data gagal.

    • Rentang versi valid untuk data kolom atribut adalah [max(waktu tulis data - offset versi maksimum, waktu tulis data - TTL), waktu tulis data + offset versi maksimum).

    allowUpdate (opsional)

    boolean

    Menentukan apakah pembaruan diizinkan.

    • Jika Anda mengatur nilainya ke false, Anda tidak dapat memperbarui data dengan menggunakan metode updateRow().

  • streamSpecification (opsional) object: Informasi konfigurasi Stream, mencakup parameter berikut.

    Parameter

    Tipe

    Deskripsi

    enableStream (opsional)

    boolean

    Menentukan apakah akan mengaktifkan Stream. Nilai default: false.

    expirationTime (opsional)

    number

    Waktu kedaluwarsa Stream, yang menunjukkan durasi retensi log inkremental. Unit: jam. Nilai maksimum: 168 (tujuh hari).

    Jika enableStream disetel ke true, Anda harus menetapkan expirationTime.

  • reservedThroughput (opsional) object: throughput baca dan tulis yang dicadangkan, dalam unit kapasitas (CUs). Hanya instans kinerja tinggi dalam Mode CU yang dapat disetel ke nilai bukan nol.

Catatan
  • Ketika memanggil metode updateTable(), Anda harus menetapkan tableOptions.

  • Ketika menetapkan tableOptions, Anda harus menetapkan setidaknya salah satu dari parameter berikut: timeToLive, maxVersions, maxTimeDeviation, atau allowUpdate.

Contoh kode

Berikut adalah contoh kode untuk memodifikasi konfigurasi tabel test_table.

var params = {
    tableName: 'test_table',
    tableOptions: {
        // Setel TTL menjadi 86400 detik
        timeToLive: 86400,
        // Setel jumlah maksimum versi
        maxVersions: 3,
        // Setel offset versi maksimum menjadi 86400 detik
        maxTimeDeviation: 86400,
        // Tentukan apakah pembaruan diizinkan
        allowUpdate: false
    },
    // Setel throughput baca yang dicadangkan menjadi 0 CUs dan throughput tulis yang dicadangkan menjadi 0 CUs (Hanya instans kinerja tinggi dalam Mode CU yang mendukung pengaturan nilai bukan nol untuk throughput baca dan tulis yang dicadangkan)
    reservedThroughput: {
        capacityUnit: {
            read: 0,
            write: 0
        }
    },
    // Aktifkan Stream dan setel waktu kedaluwarsa Stream menjadi 7 hari
    streamSpecification: {
        enableStream: true,
        expirationTime: 168
    }
};

client.updateTable(params, function (err, data) {
    if (err) {
        console.error('error:', err);
        return;
    }
    console.log('success:', data);
});