Simple Log Service:Memodifikasi dan menghapus data log

RowID

RowID adalah pengidentifikasi logis catatan yang diberikan oleh Simple Log Service ke setiap entri log yang ditulis ke Logstore dengan fitur pembaruan dan penghapusan tingkat baris diaktifkan. Semua operasi modifikasi dan penghapusan menggunakan RowID untuk menemukan catatan target.

• Format: Simple Log Service menghasilkan RowID saat penulisan. Anda tidak dapat menyesuaikan atau membuat RowID sendiri. Perlakukan sebagai pengidentifikasi tak transparan (opaque).

• Stabilitas: RowID tetap tidak berubah sepanjang siklus hidup catatan log. Bahkan setelah Anda memodifikasi catatan, RowID yang sama tetap merujuk ke catatan tersebut.

• Visibilitas: Hasil kueri dari Logstore dengan fitur ini diaktifkan secara otomatis menyertakan bidang bawaan __rowid__. Ini adalah nama bidang yang dicadangkan dan tidak dapat digunakan dalam konfigurasi indeks.

AffectedRows

Setiap permintaan modifikasi atau penghapusan yang berhasil mengembalikan AffectedRows, yang menunjukkan jumlah catatan log yang benar-benar terpengaruh oleh operasi tersebut. Gunakan nilai ini untuk memverifikasi bahwa operasi berjalan sesuai harapan.

Aktifkan melalui OpenAPI

Panggil API CreateLogStore dan atur enableModify ke true dalam badan permintaan:

POST /logstores HTTP/1.1
Host: <project>.<endpoint>
Content-Type: application/json

{
  "logstoreName": "my-logstore",
  "ttl": 30,
  "shardCount": 1,
  "enableModify": true
}

Setelah membuat Logstore, panggil API GetLogStore untuk memverifikasi. Jika badan respons berisi "enableModify": true, berarti fitur telah diaktifkan.

Aktifkan melalui Python SDK

from aliyun.log import LogClient

# Dapatkan kredensial AccessKey dari variabel lingkungan.
client = LogClient(endpoint, access_key_id, access_key)

client.create_logstore(
    project_name="my-project",
    logstore_name="my-logstore",
    ttl=30,
    shard_count=1,
    enable_modify=True,
)

Metode 1: Memodifikasi dan menghapus berdasarkan RowID

Gunakan metode ini ketika Anda sudah memiliki RowID dari catatan tertentu, biasanya diperoleh dari hasil kueri sebelumnya.

from aliyun.log import LogClient, LogItem

client = LogClient(endpoint, access_key_id, access_key)

# Tentukan hanya bidang yang akan diperbarui. Bidang yang tidak disebutkan mempertahankan nilai aslinya.
new_item = LogItem(
    contents=[("status", "REFUNDED")],
)

resp = client.update_logs(
    project="my-project",
    logstore="my-logstore",
    rowid=rowid,
    log_item=new_item,
)
print(f"Baris yang terpengaruh: {resp.affected_rows}")

resp = client.delete_logs_v2(
    project="my-project",
    logstore="my-logstore",
    rowid=rowid,
)
print(f"Baris yang terpengaruh: {resp.affected_rows}")

Metode 2: Memodifikasi dan menghapus berdasarkan kueri

Gunakan metode ini untuk memodifikasi atau menghapus catatan secara batch yang sesuai dengan kondisi kueri. Simple Log Service menjalankan kueri di sisi server dan menerapkan modifikasi atau penghapusan ke semua catatan yang sesuai.

resp = client.delete_logs_v2(
    project="my-project",
    logstore="my-logstore",
    from_time=1716537600,
    to_time=1716624000,
    query='level: DEBUG',
)
print(f"Baris yang dihapus: {resp.affected_rows}")

resp = client.update_logs(
    project="my-project",
    logstore="my-logstore",
    from_time=1716537600,
    to_time=1716624000,
    query='order_id: 12345 and status: "PENDING"',
    update_fields={"status": "REFUNDED", "refund_at": "2026-05-25T10:00:00Z"},
)
print(f"Baris yang dimodifikasi: {resp.affected_rows}")

Dapatkah saya mengaktifkan fitur ini untuk Logstore yang sudah ada?

Tidak. Fitur ini bergantung pada format penyimpanan dasar yang hanya tersedia saat pembuatan Logstore. Untuk menggunakan fitur ini, buat Logstore baru dengan enableModify=true, lalu migrasikan data historis ke Logstore baru melalui transformasi data atau SDK.

Apakah operasi modifikasi dan penghapusan memengaruhi konsumen real-time?

Tidak. Konsumen LogHub dan tugas pengiriman (seperti pengiriman ke OSS atau MaxCompute) beroperasi pada aliran tulis asli dan tidak mencerminkan modifikasi atau penghapusan. Hanya jalur pembacaan berbasis kueri (Search, SQL, dan SPL) yang mengembalikan data terbaru.

Apakah modifikasi dan penghapusan langsung terlihat?

Ya. Setelah permintaan berhasil, kueri baru mengembalikan data yang diperbarui. Nilai AffectedRows dalam respons menunjukkan jumlah catatan yang benar-benar dimodifikasi atau dihapus.

Dapatkah saya mengembalikan modifikasi atau penghapusan yang tidak disengaja?

Tidak. Tidak ada mekanisme rollback bawaan. Sebelum menjalankan operasi modifikasi atau penghapusan, gunakan Search atau SQL untuk melihat pratinjau catatan yang sesuai dengan kondisi kueri Anda. Kami menyarankan Anda menggunakan pengguna RAM khusus dengan izin terbatas untuk operasi ini dan mengaktifkan ActionTrail untuk auditing.

Apakah penghapusan langsung membebaskan ruang penyimpanan?

Penghapusan adalah operasi logis. Penyimpanan dasar tetap dipertahankan hingga TTL (time to live) Logstore berakhir atau tugas kompaksi latar belakang dijalankan. Namun, semua jalur kueri menyaring catatan yang dihapus, sehingga data yang dihapus tidak terlihat oleh pengguna.