Tair (Redis® OSS-Compatible):exString

Genel bakış

Yerel Redis dizeleri bir anahtar-değer çifti saklar. TairString her anahtara bir sürüm numarası ekler; bu sayede harici koordinasyona gerek kalmadan çakışma tespiti için hafif bir mekanizma sunar. Başarılı olan her yazma işlemi sürümü 1 artırır; yanlış sürüm belirten bir yazma isteği ise reddedilir.

TairString ayrıca EXINCRBY ve EXINCRBYFLOAT komutlarında minimum veya maksimum sınır belirlemenize olanak tanır. Bir artırma işlemi değeri bu aralığın dışına taşıracaksa komut, aralık dışı değeri yazmak yerine hata döndürür.

Temel yetenekler

• Her TairString anahtarı, değerin yanında bir sürüm numarası taşır.

• EXSET ve EXINCRBY, anahtarı en son okuduğunuzdan beri sürüm değiştiyse yazmayı reddeden bir VER seçeneğini kabul eder; bu sayede ayrı bir işlem olmadan karşılaştır-ve-ayarla (compare-and-set) uygulanır.

• EXINCRBY ve EXINCRBYFLOAT, sayacı tanımlı bir aralıkta sınırlayan MIN ve MAX seçeneklerini destekler.

Bu modül açık kaynaklıdır. Daha fazla bilgi için bkz. GitHub.

127.0.0.1:6379> EXSET foo 100
OK
127.0.0.1:6379> EXGET foo
1) "100"
2) (integer) 1
127.0.0.1:6379> EXSET foo 200 VER 1
OK
127.0.0.1:6379> EXGET foo
1) "200"
2) (integer) 2
127.0.0.1:6379> EXSET foo 300 VER 1
(error) ERR update version is stale
127.0.0.1:6379> EXCAS foo 400 2
1) OK
2)
3) (integer) 3
127.0.0.1:6379> EXCAD foo 3
(integer) 1

Önkoşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• Küçük sürümü 1.2.3 veya üzeri olan bir Tair DRAM tabanlı veya kalıcı bellek optimizasyonlu örnek

En son küçük sürüm daha fazla özellik ve daha yüksek kararlılık sağlar. Örneği en son küçük sürüme güncelleyin. Daha fazla bilgi için bkz. Bir örneğin küçük sürümünü güncelleme . Küme veya okuma/yazma ayrıştırma örnekleri için, tüm komutların beklendiği gibi çalışmasını sağlamak üzere proxy düğümlerini de en son küçük sürüme güncelleyin.

Kullanım notları

TairString verileri bir Tair örneğinde depolanır. Yerel Redis dizeleri ve TairString'ler aynı Tair örneğinde birlikte bulunabilir; ancak yerel Redis dizeleri bu konuda açıklanan komutları desteklemez.

Komut özeti

Sözdizimi kuralları

• BÜYÜK_HARF: komut anahtar sözcüğü.

• eğik: değişken.

• [seçenekler]: isteğe bağlı parametre. Köşeli parantez içermeyen parametreler zorunludur.

• A|B: karşılıklı olarak özel seçenekler; yalnızca birini belirtin.

• ...: önceki parametre tekrarlanabilir.

EXSET

Parametreler

• key: yazılacak anahtar.

• value: yazılacak değer.

• EX time: saniye cinsinden göreli son kullanma süresi. 0 anahtarın hemen sona ereceği anlamına gelir. Atlanırsa anahtar sona ermez.

• EXAT time: saniye cinsinden mutlak son kullanma zamanı (Unix zaman damgası). 0 anahtarın hemen sona ereceği anlamına gelir. Atlanırsa anahtar sona ermez.

• PX time: milisaniye cinsinden göreli son kullanma süresi. 0 anahtarın hemen sona ereceği anlamına gelir. Atlanırsa anahtar sona ermez.

• PXAT time: milisaniye cinsinden mutlak son kullanma zamanı (Unix zaman damgası). 0 anahtarın hemen sona ereceği anlamına gelir. Atlanırsa anahtar sona ermez.

• NX: yalnızca anahtar yoksa yaz.

• XX: yalnızca anahtar zaten varsa yaz.

• VER version: sürüm numarasına göre karşılaştır-ve-ayarla.

  • Anahtar varsa: belirtilen sürüm geçerli sürümle eşleştiğinde yazma başarılı olur; ardından sürüm 1 artırılır. Sürümler eşleşmezse hata döndürülür.

  • Anahtar yoksa veya geçerli sürümü 0 ise: VER değeri yoksayılır, yazma başarılı olur ve sürüm 1 olarak ayarlanır.

• ABS version: sürümü koşulsuz olarak üzerine yazar. Yazmadan sonra sürüm, belirtilen ABS değerine eşit olur.

• KEEPTTL: anahtarın kalan TTL (time-to-live) değerini devralır. EX, PX, EXAT veya PXAT ile birlikte kullanılamaz.

Son kullanma parametresi ayarlanmamışsa ( EX , PX , EXAT , PXAT veya KEEPTTL ), anahtar sona ermez.

Dönüş değerleri

• OK: yazma başarılı oldu.

• nil: XX belirtildi ancak anahtar yok veya NX belirtildi ancak anahtar zaten var.

• Hata: diğer tüm başarısızlıklar.

Örnek

EXSET foo bar EX 10 NX ABS 100

OK

EXGET

Parametreler

• key: okunacak anahtar.

Dönüş değerleri

• Değeri (bulk string) ve sürüm numarasını (integer) içeren bir dizi.

• Hata: anahtar yok veya başka bir başarısızlık oluştu.

Örnek

EXGET foo

1) "bar"
2) (integer) 1

EXSETVER

Parametreler

• key: güncellenecek anahtar.

• version: atanacak sürüm numarası.

Dönüş değerleri

• 1: sürüm başarıyla ayarlandı.

• 0: anahtar yok.

• Hata: başka bir başarısızlık oluştu.

Örnek

EXSETVER foo 2

(integer) 1

EXINCRBY

Parametreler

• key: güncellenecek anahtar.

• num: eklenecek tamsayı miktarı (azaltmak için negatif değer kullanın).

• EX, EXAT, PX, PXAT, NX, XX, VER, ABS, KEEPTTL: EXSET ile aynı.

• MIN minval: izin verilen minimum değer. Sonuç minval değerinden düşük olursa komut hata döndürür ve yazma yapmaz.

• MAX maxval: izin verilen maksimum değer. Sonuç maxval değerini aşarsa komut hata döndürür ve yazma yapmaz.

Son kullanma parametresi ayarlanmamışsa ( EX , PX , EXAT , PXAT veya KEEPTTL ), anahtar sona ermez.

Dönüş değerleri

• Güncellenen değer (integer): artırma başarılı oldu.

• (error) ERR increment or decrement would overflow: sonuç MIN/MAX aralığının dışına çıkacak.

• Hata: başka bir başarısızlık oluştu.

Örnek

Aşağıdaki örnek, önceden EXSET foo 1 çalıştırıldığını varsayar. Komut, foo değerini 100 artırır ve değeri maksimum 300 ile sınırlar.

EXINCRBY foo 100 MAX 300

(integer) 101

Desen: sınırlı sayaç

Sınırlarını asla aşmayan bir hız sınırlayıcı veya kota sayacı uygulamak için MIN ve MAX kullanın:

# Initialize the counter
EXSET requests 0

# Increment on each request; reject when the limit is hit
EXINCRBY requests 1 MAX 100
# Returns (error) ERR increment or decrement would overflow when the limit is reached

EXINCRBYFLOAT

Parametreler

• key: güncellenecek anahtar.

• num: eklenecek kayan noktalı miktar (azaltmak için negatif değer kullanın).

• Diğer tüm seçenekler (EX, EXAT, PX, PXAT, NX, XX, VER, ABS, KEEPTTL, MIN, MAX): EXINCRBY ile aynı.

Son kullanma parametresi ayarlanmamışsa ( EX , PX , EXAT , PXAT veya KEEPTTL ), anahtar sona ermez.

Dönüş değerleri

• Güncellenen değer: artırma başarılı oldu.

• (error) ERR increment or decrement would overflow: sonuç MIN/MAX aralığının dışına çıkacak.

• Hata: başka bir başarısızlık oluştu.

Örnek

Aşağıdaki örnek, önceden EXSET foo 1 çalıştırıldığını varsayar.

EXINCRBYFLOAT foo 10.123

(integer) 11.123

EXCAS

Parametreler

• key: güncellenecek anahtar.

• newvalue: sürüm eşleşirse yazılacak değer.

• version: geçerli sürümle karşılaştırılacak sürüm numarası.

Dönüş değerleri

• ["OK", "", latest_version]: güncelleme başarılı oldu. Ortadaki boş dizenin bir anlamı yoktur.

• ["ERR update version is stale", current_value, current_version]: sürüm eşleşmedi. Anahtar değiştirilmedi.

• -1: anahtar yok.

• Hata: başka bir başarısızlık oluştu.

Örnek

Aşağıdaki örnek, önceden EXSET foo bar çalıştırıldığını varsayar (sürüm = 1).

EXCAS foo bzz 1

1) OK
2)
3) (integer) 2

Desen: iyimser kilitleme

Kilit olmadan oku-değiştir-yaz döngüsü uygulamak için EXCAS kullanın:

# 1. Read the current value and version
EXGET mykey
# Returns: value="old", version=5

# 2. Modify locally

# 3. Write back only if the version hasn't changed
EXCAS mykey "new" 5
# If another writer changed the key, EXCAS returns the stale-version error.
# Retry from step 1.

EXCAD

Parametreler

• key: silinecek anahtar.

• version: geçerli sürümle karşılaştırılacak sürüm numarası.

Dönüş değerleri

• 1: anahtar silindi.

• 0: sürüm eşleşmedi; anahtar silinmedi.

• -1: anahtar yok.

• Hata: başka bir başarısızlık oluştu.

Örnek

Aşağıdaki örnek, önceden EXSET foo bar çalıştırıldığını varsayar (sürüm = 1).

EXCAD foo 1

(integer) 1

Sonraki adımlar

• TairString kullanarak yüksek performanslı dağıtılmış kilitler uygulama

• TairString kullanarak yüksek performanslı iyimser kilitleme uygulama

• TairString kullanarak sınırlı sayaçlar uygulama