Mengubah mode umpan di Azure Cosmos DB

BERLAKU UNTUK: NoSQL

Azure Cosmos DB menawarkan dua mode umpan perubahan. Setiap mode menawarkan fungsionalitas inti yang sama. Perbedaan termasuk operasi yang diambil dalam umpan, metadata yang tersedia untuk setiap perubahan, dan periode retensi perubahan. Anda dapat menggunakan umpan perubahan dalam mode yang berbeda di beberapa aplikasi untuk kontainer Azure Cosmos DB yang sama agar sesuai dengan persyaratan setiap beban kerja. Setiap aplikasi umpan perubahan individu hanya dapat dikonfigurasi untuk membaca umpan perubahan dalam satu mode. Mengonsumsi umpan perubahan dalam satu mode tidak melarang Anda mengonsumsi umpan perubahan dalam mode lain dalam aplikasi yang berbeda.

Catatan

Apakah Anda memiliki umpan balik tentang mode umpan perubahan? Kami ingin mendengar pendapat Anda! Jangan ragu untuk berbagi umpan balik langsung dengan tim teknik Azure Cosmos DB: cosmoschangefeed@microsoft.com.

Mode umpan perubahan versi terbaru

Mode versi terbaru adalah catatan perubahan persisten yang dilakukan pada item dari pembuatan dan pembaruan. Anda mendapatkan versi terbaru dari setiap item dalam kontainer. Misalnya, jika item dibuat lalu diperbarui sebelum Anda membaca umpan perubahan, hanya versi yang diperbarui yang muncul di umpan perubahan. Penghapusan tidak diambil sebagai perubahan, dan ketika item dihapus, item tidak lagi tersedia di umpan. Mode umpan perubahan versi terbaru diaktifkan secara default dan kompatibel dengan semua akun Azure Cosmos DB kecuali API untuk Tabel dan API untuk PostgreSQL. Mode ini sebelumnya adalah cara default untuk menggunakan umpan perubahan.

Semua versi dan penghapusan mengubah mode umpan (pratinjau)

Semua versi dan mode penghapusan (pratinjau) adalah rekaman persisten dari semua perubahan pada item dari operasi buat, perbarui, dan hapus. Anda mendapatkan catatan setiap perubahan pada item dalam urutan terjadinya, termasuk perubahan perantara pada item di antara pembacaan umpan perubahan. Misalnya, jika item dibuat lalu diperbarui sebelum Anda membaca umpan perubahan, baik versi buat maupun pembaruan item muncul di umpan perubahan. Untuk membaca dari umpan perubahan di semua versi dan mode penghapusan, Anda harus memiliki cadangan berkelanjutan yang dikonfigurasi untuk akun Azure Cosmos DB Anda. Mengaktifkan pencadangan berkelanjutan membuat semua versi dan menghapus umpan perubahan. Anda hanya dapat membaca perubahan yang terjadi dalam periode pencadangan berkelanjutan saat menggunakan mode umpan perubahan ini. Mode ini hanya kompatibel dengan Azure Cosmos DB untuk akun NoSQL. Pelajari selengkapnya tentang cara mendaftar untuk pratinjau.

Mengubah kasus penggunaan umpan

Mode versi terbaru

Mode versi terbaru menyediakan cara mudah untuk memproses perubahan real time dan historis pada item dalam kontainer dengan kemampuan untuk kembali ke perubahan dari awal kontainer.

Berikut ini adalah skenario yang cocok untuk mode ini:

• Migrasi seluruh kontainer ke lokasi sekunder.

• Kemampuan untuk memproses ulang perubahan dari awal kontainer.

• Pemrosesan perubahan real time pada item dalam kontainer yang dihasilkan dari operasi buat dan perbarui.

• Beban kerja yang tidak perlu mengambil penghapusan atau perubahan menengah antar bacaan.

Semua versi dan mode penghapusan (pratinjau)

Semua versi dan penghapusan mode umpan perubahan memungkinkan skenario baru untuk umpan perubahan, dan menyederhanakan yang lain. Anda dapat membaca setiap perubahan yang terjadi pada item (bahkan dalam kasus di mana beberapa perubahan terjadi di antara umpan perubahan dibaca), mengidentifikasi jenis operasi perubahan yang sedang diproses, dan mendapatkan perubahan yang dihasilkan dari penghapusan.

Beberapa skenario umum yang diaktifkan dan ditingkatkan mode ini adalah:

• Transfer data secara real time antara dua lokasi tanpa menerapkan penghapusan sementara.

• Memicu logika berdasarkan perubahan inkremental jika beberapa operasi perubahan untuk item tertentu diharapkan di antara polling umpan perubahan.

• Memicu pemberitahuan tentang operasi penghapusan, seperti dalam skenario audit.

• Kemampuan untuk memproses item membuat, memperbarui, dan menghapus secara berbeda berdasarkan jenis operasi.

Fitur dari setiap mode

Selain fitur umum di semua mode umpan perubahan, setiap mode umpan perubahan memiliki karakteristik berikut:

Mode versi terbaru

• Umpan perubahan mencakup operasi sisipkan dan perbarui yang dibuat ke item dalam kontainer.

• Mode umpan perubahan ini tidak menghapus log. Anda dapat mengambil penghapusan dengan mengatur bendera "penghapusan sementara" dalam item Anda alih-alih menghapusnya secara langsung. Misalnya, Anda dapat menambahkan atribut dalam item yang disebut deleted dengan nilai true, lalu mengatur Time to Live (TTL) pada item. Umpan perubahan menangkapnya sebagai pembaruan dan item dihapus secara otomatis saat TTL kedaluwarsa. Atau, Anda dapat mengatur periode kedaluwarsa terbatas untuk item Anda dengan menggunakan kemampuan TTL. Dengan solusi ini, Anda harus memproses perubahan dalam interval waktu yang lebih singkat daripada periode kedaluwarsa TTL.

• Hanya perubahan terbaru untuk item tertentu yang disertakan dalam umpan perubahan. Perubahan menengah mungkin tidak tersedia.

• Saat item dihapus, item tidak lagi tersedia di umpan perubahan.

• Perubahan dapat disinkronkan dari titik waktu mana pun, dan tidak ada periode retensi data tetap yang perubahannya tersedia.

• Anda tidak dapat memfilter umpan perubahan untuk jenis operasi tertentu. Salah satu alternatif yang mungkin, adalah menambahkan "penanda lunak" pada item untuk pembaruan dan filter berdasarkan penanda saat Anda memproses item di umpan perubahan.

• Titik awal untuk membaca umpan perubahan dapat dari awal kontainer, dari titik waktu tertentu, dari "sekarang," atau dari titik pemeriksaan tertentu. Presisi waktu mulai adalah sekitar lima detik.

Semua versi dan mode penghapusan (pratinjau)

• Umpan perubahan mencakup operasi sisipkan, perbarui, dan hapus yang dibuat untuk item dalam kontainer. Penghapusan dari kedaluwarsa TTL juga diambil.

• Metadata disediakan untuk menentukan jenis perubahan, termasuk apakah penghapusan disebabkan oleh kedaluwarsa TTL.

• Ubah item feed datang dalam urutan waktu modifikasinya. Penghapusan dari kedaluwarsa TTL tidak dijamin muncul di umpan segera setelah item kedaluwarsa. Item muncul saat item dihapus menyeluruh dari kontainer.

• Semua perubahan yang terjadi dalam jendela retensi yang diatur untuk pencadangan berkelanjutan pada akun dapat dibaca. Mencoba membaca perubahan yang terjadi di luar jendela retensi menghasilkan kesalahan. Misalnya, jika kontainer Anda dibuat delapan hari yang lalu dan periode retensi periode pencadangan berkelanjutan Anda adalah tujuh hari, maka Anda hanya dapat membaca perubahan dari tujuh hari terakhir.

• Titik awal umpan perubahan dapat berasal dari "sekarang" atau dari titik pemeriksaan tertentu dalam periode retensi Anda. Anda tidak dapat membaca perubahan dari awal kontainer atau dari titik waktu tertentu dengan menggunakan mode ini.

Bekerja dengan umpan perubahan

Setiap mode kompatibel dengan metode yang berbeda untuk membaca umpan perubahan untuk setiap bahasa.

Mode versi terbaru

Anda dapat menggunakan cara berikut untuk menggunakan perubahan dari umpan perubahan dalam mode versi terbaru:

Metode untuk membaca umpan perubahan	.NET	Java	Python	Node.js
Model penarikan umpan perubahan	Ya	Ya	Ya	Ya
Mengubah prosesor umpan	Ya	Ya	No	Tidak
Pemicu Azure Functions	Ya	Ya	Ya	Ya

Mengurai objek respons

Dalam mode versi terbaru, objek respons default adalah array item yang telah berubah. Setiap item berisi metadata standar untuk item Azure Cosmos DB apa pun, termasuk _etag dan _ts, dengan penambahan properti baru, _lsn.

Formatnya _etag internal dan Anda tidak boleh mengambil dependensi karena dapat berubah kapan saja. _ts adalah modifikasi atau stempel waktu pembuatan. Anda dapat menggunakan _ts untuk perbandingan kronologis. _lsn adalah ID batch yang ditambahkan untuk umpan perubahan saja yang mewakili ID transaksi. Banyak item dapat memiliki hal yang sama _lsn.

ETag aktif FeedResponse berbeda dari yang _etag Anda lihat pada item. _etag adalah pengidentifikasi internal, dan digunakan untuk kontrol konkurensi. Properti _etag mewakili versi item, sedangkan ETag properti digunakan untuk mengurutkan umpan.

Semua versi dan mode penghapusan (pratinjau)

Selama pratinjau, metode berikut untuk membaca umpan perubahan tersedia untuk setiap SDK klien:

Metode untuk membaca umpan perubahan	.NET	Java	Python	Node.js
Model penarikan umpan perubahan	>= 3.32.0-pratinjau	>= 4.42.0	No	>= 4.1.0
Mengubah prosesor umpan	No	>= 4.42.0	Tidak	Tidak
Pemicu Azure Functions	Tidak	No	No	No

Catatan

Terlepas dari mode koneksi yang dikonfigurasi dalam aplikasi Anda, semua permintaan yang dibuat dengan semua versi dan umpan perubahan penghapusan akan menggunakan mode Gateway.

Memulai

Untuk mulai menggunakan semua versi dan menghapus mode umpan perubahan, daftar di pratinjau melalui halaman Fitur Pratinjau di halaman gambaran umum Langganan Azure Anda. Cari fitur AllVersionsAndDeletesChangeFeed dan pilih Daftar.

Sebelum mengirimkan permintaan, pastikan Anda memiliki setidaknya satu akun Azure Cosmos DB dalam langganan. Akun ini bisa menjadi akun yang sudah ada atau akun baru yang Anda buat untuk mencoba fitur pratinjau. Jika Anda tidak memiliki akun dalam langganan saat tim Azure Cosmos DB menerima permintaan Anda, permintaan ditolak karena tidak ada akun untuk menerapkan fitur tersebut.

Tim Azure Cosmos DB meninjau permintaan Anda dan menghubungi Anda melalui email untuk mengonfirmasi akun Azure Cosmos DB mana dalam langganan yang ingin Anda daftarkan dalam pratinjau. Untuk menggunakan pratinjau, Anda harus memiliki cadangan berkelanjutan yang dikonfigurasi untuk akun Azure Cosmos DB Anda. Pencadangan berkelanjutan dapat diaktifkan baik sebelum atau sesudah dimasukkan ke pratinjau, tetapi pencadangan berkelanjutan harus diaktifkan sebelum Anda mencoba membaca dari umpan perubahan di semua versi dan mode penghapusan.

Mengurai objek respons

Objek respons adalah array item yang mewakili setiap perubahan. Array terlihat seperti contoh berikut:

[
    {  
        "current": { 
            <The current version of the item that changed. All the properties of your item will appear here. This will be empty for delete operations.>
         },  
        "previous" : { 
            <The previous version of the item that changed. If the change was a delete operation, the item that was deleted will appear here. This will be empty for create and replace operations.>
         },  
        "metadata": {
            "lsn": <A number that represents the batch ID. Many items can have the same lsn.>, 
            "operationType": <The type of change, either 'create', 'replace', or 'delete'.>, 
            "previousImageLSN" : <A number that represents the batch ID of the change prior to this one.>, 
            "timeToLiveExpired" : <For delete changes, it will be 'true' if it was deleted due to a TTL expiration and 'false' if it wasn't.>, 
            "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.> 
        } 
    }
]

Batasan

• Didukung untuk Azure Cosmos DB untuk akun NoSQL. Jenis akun Azure Cosmos DB lainnya tidak didukung.

• Pencadangan berkelanjutan diperlukan untuk menggunakan mode umpan perubahan ini. Batasan penggunaan cadangan berkelanjutan dapat ditemukan dalam dokumentasi.

• Membaca perubahan pada kontainer yang ada sebelum pencadangan berkelanjutan diaktifkan pada akun tidak didukung.

• Kemampuan untuk mulai membaca umpan perubahan dari awal atau untuk memilih waktu mulai berdasarkan stempel waktu sebelumnya saat ini tidak didukung. Anda dapat mulai dari "sekarang" atau dari token sewa atau kelanjutan sebelumnya.

• Menerima versi item sebelumnya yang telah diperbarui saat ini tidak tersedia.

• Akun yang telah mengaktifkan penggabungan partisi tidak didukung.

Langkah berikutnya

Pelajari selengkapnya tentang umpan perubahan di artikel berikut ini:

• Ringkasan umpan perubahan
• Mengubah pola desain umpan
• Opsi untuk membaca ubah umpan