全部产品
Search
文档中心

Tablestore:Memperbarui konfigurasi tabel

更新时间:Jul 09, 2025

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

Prasyarat

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

Deskripsi metode

public UpdateTableResponse UpdateTable(UpdateTableRequest request)

Metode asinkron:

public Task<UpdateTableResponse> UpdateTableAsync(UpdateTableRequest request)

Parameter UpdateTableRequest

  • NamaTabel (wajib) string: Nama tabel data.

  • OpsiTabel (opsional) TableOptions: Informasi konfigurasi tabel, mencakup parameter berikut.

    Parameter

    Tipe

    Deskripsi

    WaktuHidup (opsional)

    int

    Waktu hidup (TTL) data dalam tabel data dalam detik. Nilai default adalah -1.

    • Jika Anda mengatur parameter ini ke -1, data tidak akan 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 mengatur parameter ini ke -1 atau mengatur parameter AllowUpdate ke false.

    VersiMaksimum (opsional)

    int

    Jumlah maksimum versi. Nilai default adalah 1.

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

    DeviasiVersiSelDalamDetik (opsional)

    long

    Offset versi maksimum dalam 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(WaktuPenulisanData - OffsetVersiMaksimum, WaktuPenulisanData - TTL), WaktuPenulisanData + OffsetVersiMaksimum).

    IzinkanPembaruan (opsional)

    bool

    Menunjukkan apakah pembaruan diperbolehkan.

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

  • SpesifikasiStream (opsional) StreamSpecification: Informasi konfigurasi Stream, mencakup parameter berikut.

    Parameter

    Tipe

    Catatan

    AktifkanStream (wajib)

    bool

    Menentukan apakah akan mengaktifkan Stream.

    WaktuKedaluwarsa (opsional)

    int

    Waktu kedaluwarsa Stream, yang mewakili durasi penyimpanan log inkremental. Satuannya adalah jam. Nilai maksimumnya adalah 168 (tujuh hari).

    • Ketika AktifkanStream disetel ke true, Anda harus menentukan WaktuKedaluwarsa.

  • ThroughputTercadang (opsional) CapacityUnit: Throughput baca dan tulis tercadang, dalam CU. Anda dapat mengatur parameter ini ke nilai bukan nol, yang hanya berlaku untuk tabel data dalam instans performa tinggi dalam mode CU.

Catatan

Saat memanggil metode UpdateTable(), Anda harus menentukan setidaknya satu dari OpsiTabel, SpesifikasiStream, atau ThroughputTercadang.

Contoh kode

try
{
    UpdateTableRequest request = new UpdateTableRequest("test_table");

    // Informasi konfigurasi tabel.
    TableOptions tableOptions = new TableOptions();
    // Tentukan TTL dalam detik.
    tableOptions.TimeToLive = 86400;
    // Tentukan jumlah maksimum versi.
    tableOptions.MaxVersions = 3;
    // Tentukan offset versi maksimum dalam detik.
    tableOptions.DeviationCellVersionInSec = 86400;
    // Tentukan apakah pembaruan diperbolehkan.
    tableOptions.AllowUpdate = false;
    request.TableOptions = tableOptions;

    // Aktifkan Stream dan atur periode validitas Stream menjadi tujuh hari.
    StreamSpecification streamSpecification = new StreamSpecification(true);
    streamSpecification.ExpirationTime = 168;
    request.StreamSpecification = streamSpecification;

    // Atur throughput baca tercadang ke 0 CU dan throughput tulis tercadang ke 0 CU (Anda dapat mengatur parameter ini ke nilai bukan nol dan pengaturan ini hanya berlaku untuk tabel data dalam instans performa tinggi dalam mode CU).
    CapacityUnit reservedThroughput = new CapacityUnit(0, 0);
    request.ReservedThroughput = reservedThroughput;

    // Panggil metode UpdateTable untuk memodifikasi konfigurasi tabel.
    client.UpdateTable(request);
    Console.WriteLine("Pembaruan tabel berhasil.");
}
catch (Exception ex)
{
    Console.WriteLine($"Pembaruan tabel gagal, pengecualian:{ex.Message}");
}