Peningkatan perintah string baru untuk instans Tair - Tair (Redis® OSS-Compatible)

Topik ini menjelaskan perintah CAS dan CAD baru untuk instans Tair, yang meningkatkan fungsionalitas string Redis.

Prasyarat

Instans tersebut adalah instans Tair berbasis DRAM atau dioptimalkan memori persisten dengan versi minor 1.2.3 atau lebih baru.

Catatan

Versi minor terbaru menyediakan lebih banyak fitur dan stabilitas yang lebih tinggi. Kami menyarankan Anda untuk memperbarui instans ke versi minor terbaru. Untuk informasi lebih lanjut, lihat Perbarui versi minor sebuah instans. Jika instans Anda adalah instans kluster atau instans pemisahan baca/tulis, kami menyarankan Anda untuk memperbarui node proxy di dalam instans ke versi minor terbaru untuk memastikan bahwa semua perintah dapat dijalankan sesuai harapan.

Catatan penggunaan

Perintah dalam topik ini berlaku untuk string Redis asli.

Catatan

Sebuah instans Tair dapat berisi baik string Redis maupun TairStrings. Perintah dalam topik ini tidak berlaku untuk TairStrings.

Daftar perintah

Tabel 1. Perintah Peningkatan String

Perintah	Sintaksis	Deskripsi
CAS	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`	CAS (Compare And Set) memeriksa apakah nilai dari kunci target sama dengan oldvalue yang ditentukan. Jika nilainya sama, perintah memperbarui nilai menjadi newvalue yang baru. Jika tidak, perintah tidak melakukan apa pun. Catatan Perintah ini hanya berlaku untuk string Redis. Untuk melakukan operasi yang sama pada TairStrings, gunakan perintah EXCAS.
CAD	`CAD key value`	CAD (Compare And Delete) memeriksa apakah nilai dari kunci target sama dengan nilai yang ditentukan. Jika nilainya sama, perintah menghapus kunci tersebut. Jika tidak, perintah tidak melakukan apa pun. Catatan Perintah ini hanya berlaku untuk string Redis. Untuk melakukan operasi yang sama pada TairStrings, gunakan perintah EXCAD.

Catatan

Daftar berikut menjelaskan konvensi sintaksis perintah yang digunakan dalam topik ini:

Kata kunci huruf besar: menunjukkan kata kunci perintah.
Teks miring: menunjukkan variabel.
[opsi]: menunjukkan bahwa parameter yang diapit oleh tanda kurung siku bersifat opsional. Parameter yang tidak diapit oleh tanda kurung harus ditentukan.
A|B: menunjukkan bahwa parameter yang dipisahkan oleh garis vertikal (|) saling eksklusif. Hanya satu dari parameter tersebut yang dapat ditentukan.
...: menunjukkan bahwa parameter sebelum simbol ini dapat ditentukan secara berulang.

CAS

Item	Deskripsi
Sintaksis	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`
Kompleksitas waktu	O(1)
Deskripsi perintah	CAS (Compare And Set) memeriksa apakah nilai dari kunci target sama dengan oldvalue yang ditentukan. Jika nilainya sama, perintah memperbarui nilai menjadi newvalue yang baru. Jika tidak, perintah tidak melakukan apa pun. Catatan Perintah ini hanya berlaku untuk string Redis. Untuk melakukan operasi yang sama pada TairStrings, gunakan perintah EXCAS.
Opsi	Key: Kunci target dari tipe string. oldvalue: Nilai awal untuk dibandingkan dengan nilai saat ini dari kunci. newvalue: Nilai baru. Jika `oldvalue` sama dengan nilai saat ini dari kunci, nilai diperbarui menjadi `newvalue`. EX: Mengatur waktu kedaluwarsa relatif dari kunci dalam detik. Nilai 0 berarti kunci kedaluwarsa segera. Jika Anda tidak menentukan parameter ini, kunci tidak akan kedaluwarsa. EXAT: Mengatur waktu kedaluwarsa absolut dari kunci sebagai stempel waktu UNIX dalam detik. Nilai 0 berarti kunci kedaluwarsa segera. Jika Anda tidak menentukan parameter ini, kunci tidak akan kedaluwarsa. PX: Mengatur waktu kedaluwarsa relatif dari kunci dalam milidetik. Nilai 0 berarti kunci kedaluwarsa segera. Jika Anda tidak menentukan parameter ini, kunci tidak akan kedaluwarsa. PXAT: Mengatur waktu kedaluwarsa absolut dari kunci sebagai stempel waktu UNIX dalam milidetik. Nilai 0 berarti kunci kedaluwarsa segera. Jika Anda tidak menentukan parameter ini, kunci tidak akan kedaluwarsa. Catatan Jika string asli memiliki Time to Live (TTL) yang ditetapkan, menjalankan perintah CAS tanpa parameter TTL akan menghapus TTL. Kunci kemudian tidak akan kedaluwarsa.
Nilai kembali	1: Operasi berhasil. 0: Operasi gagal. -1: Kunci tidak ada. Dalam kasus lain, pesan kesalahan dikembalikan.
Contoh	Jalankan perintah `SET foo bar` terlebih dahulu. Contoh perintah: `CAS foo bar bzz EX 10` Contoh nilai kembali: `(integer) 1` Jika Anda kemudian menjalankan perintah `GET foo`, `"bzz"` akan dikembalikan.

CAD

Item	Deskripsi
Sintaksis	`CAD key value`
Kompleksitas waktu	O(1)
Deskripsi perintah	CAD (Compare And Delete) memeriksa apakah nilai dari kunci target sama dengan nilai yang ditentukan. Jika nilainya sama, perintah menghapus kunci tersebut. Jika tidak, perintah tidak melakukan apa pun. Catatan Perintah ini hanya berlaku untuk string Redis. Untuk melakukan operasi yang sama pada TairStrings, gunakan perintah EXCAD.
Opsi	Key: Kunci target dari tipe string. value: Nilai untuk dibandingkan dengan nilai saat ini dari kunci.
Nilai kembali	1: Operasi berhasil. 0: Operasi gagal. -1: Kunci tidak ada. Dalam kasus lain, pesan kesalahan dikembalikan.
Contoh	Jalankan perintah `SET foo bar` terlebih dahulu. Contoh perintah: `CAD foo bar` Contoh nilai kembali: `(integer) 1` Kunci foo dihapus. Jika Anda kemudian menjalankan perintah `GET foo`, `(nil)` akan dikembalikan.