全部产品
Search
文档中心

Tablestore:Perbarui konfigurasi tabel

更新时间:Jul 06, 2025

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

Persyaratan awal

Klien telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi Klien Tablestore.

Deskripsi metode

public function updateTable(array $request)

Deskripsi Parameter $request

  • table_name (wajib) string: Nama tabel data.

  • table_options (opsional) object: Informasi konfigurasi tabel, mencakup parameter berikut.

    Parameter

    Tipe

    Deskripsi

    time_to_live (opsional)

    int

    Waktu hidup (TTL) data dalam tabel data. Satuan: detik.

    • Jika Anda menetapkan parameter ini ke -1, data tidak pernah kedaluwarsa. Jika tidak, nilai minimumnya adalah 86400 (satu hari). Data yang melewati periode retensi TTL akan dihapus secara otomatis.

    • Jika Anda ingin menggunakan fitur indeks pencarian atau indeks sekunder, Anda harus menetapkan parameter ini ke -1 atau menetapkan allow_update ke false.

    max_versions (opsional)

    int

    Jumlah maksimum versi.

    • Jika Anda ingin menggunakan fitur indeks pencarian atau indeks sekunder, Anda harus menetapkan parameter ini ke 1.

    deviation_cell_version_in_sec (opsional)

    int

    Offset versi maksimum. Satuan: detik.

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

    • Rentang versi valid untuk data kolom atribut adalah [max(Waktu data ditulis - Offset versi maksimum, Waktu data ditulis - TTL), Waktu data ditulis + Offset versi maksimum).

    allow_update (opsional)

    bool

    Menentukan apakah pembaruan diperbolehkan.

    • Jika Anda menetapkan parameter ini ke false, Anda tidak dapat memperbarui data dengan menggunakan metode updateRow().

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

    Parameter

    Tipe

    Deskripsi

    enable_stream (opsional)

    bool

    Menentukan apakah akan mengaktifkan Stream.

    enable_stream (opsional)

    int

    Waktu kedaluwarsa Stream, yang menunjukkan durasi penyimpanan log inkremental. Satuan: jam. Nilai maksimumnya adalah 168 (7 hari).

    • Jika Anda menetapkan enable_stream ke true, Anda harus menentukan expiration_time.

  • reserved_throughput (opsional) object: Throughput Baca dan Tulis yang Dicadangkan, dalam CU. Anda hanya dapat menetapkan parameter ini ke nilai bukan nol untuk instance performa tinggi dalam mode CU.

Catatan

Saat memanggil metode updateTable(), Anda harus menentukan setidaknya salah satu dari parameter table_options atau stream_spec.

Saat menentukan table_options, Anda harus menentukan setidaknya salah satu dari time_to_live, max_versions, deviation_cell_version_in_sec, atau allow_update.

Contoh kode

Berikut adalah contoh kode untuk memodifikasi informasi konfigurasi tabel test_table.

$request = array (
    'table_name' => 'test_table',
    'table_options' => array (
        'time_to_live' => 86400,
        'max_versions' => 3,
        'deviation_cell_version_in_sec' => 86400,
        'allow_update' => false
    ), 
     'stream_spec' => array (
        'enable_stream' => true,
        'expiration_time' => 168
     ),
    'reserved_throughput' => array (
        'capacity_unit' => array (
            'read' => 0,
            'write' => 0
        )
    )
);

try{
    $client->updateTable( $request );
    echo "Pembaruan tabel berhasil.";
} catch (Exception $e) {
    echo "Pembaruan tabel gagal.";
}