Tair (Redis® OSS-Compatible):exZset

Genel Bakış

Redis sıralı kümeleri üye başına yalnızca tek bir puanı destekler; bu durum çok boyutlu sıralamayı zorlaştırır. Puanları IEEE 754 kodlamasıyla birleştirme veya dize birleştirme gibi yaygın geçici çözümler, hassasiyet kaybına, karmaşık kodlama/çözümleme mantığına ve bireysel puan boyutlarının atomik olarak artırılmasının mümkün olmamasına neden olur.

TairZset, yerel çok boyutlu bir veri yapısıyla bu sorunu çözer:

• Üye başına en fazla 256 puan boyutu; biçim: score1#score2#...#scoreN

• Soldan sağa öncelik: İki üye karşılaştırılırken ilk boyut önce değerlendirilir; eşitse ikinci boyuta geçilir ve bu şekilde devam eder.

• Atomik artırımlar: EXZINCRBY komutu, okuma-değiştirme-yazma döngülerine gerek kalmadan belirli bir boyutu artırır.

• API uyumluluğu: Komutlar yerel sıralı küme komutlarını yansıtır; istemcinizde kodlama veya çözümleme mantığı gerektirmez.

• Normal ve dağıtılmış liderlik tabloları: Hem tek düğümlü hem de dağıtılmış liderlik tablosu mimarilerini destekler.

• Açık kaynaklı TairJedis istemcisi: TairJedis SDK adresinde mevcuttur; diğer diller için istemci uygulamalarına referans olarak açık kaynak kodunu kullanabilirsiniz.

Modülün açık kaynak koduna GitHub'daki TairZset sayfasından erişebilirsiniz.

Kullanım senaryoları

Çok boyutlu puanlama, tek bir metriğin yeterli olmadığı tüm liderlik tabloları için TairZset'i doğal bir seçim haline getirir:

• Canlı yayın liderlik tabloları: Yayıncıları önce popülerliğe, sonra beğeni sayısına, ardından hediye tutarına göre sıralayın — popularity#likes#gift_amount

• Madalya sıralamaları: Yarışmacıları önce altın, sonra gümüş, ardından bronz madalya sayısına göre sıralayın — gold#silver#bronze

• Oyun liderlik tabloları: Oyuncuları önce puana, sonra görev tamamlama süresine, ardından oyuncu rütbesine göre sıralayın — score#completion_time#player_rank

Ön koşullar

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

• Bir Tair bellek optimize edilmiş örnek

• Redis 5.0 ile uyumlu bellek optimize edilmiş örnekler için: küçük sürüm 1.7.1 veya üzeri

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

Kullanım notları

• Tüm TairZset komutları, Tair örneklerindeki TairZset verileri üzerinde çalışır. Bu komutları farklı bir veri türü içeren bir anahtar üzerinde çalıştırmak hata döndürür.

• Puan biçimi tutarlılığı: Aynı anahtardaki tüm üyeler aynı sayıda puan boyutu kullanmalıdır. Aynı anahtarda 1#2#3 ve 1#2 karışımı hata oluşturur.

• Artırım biçimi: EXZINCRBY içindeki increment değeri, hedef üyenin puan boyutu biçimiyle eşleşmelidir. Üç boyutlu bir puanın yalnızca bir boyutunu artırmak için üç boyutu da belirtin (ör. EXZINCRBY key 0#1#0 member).

• +inf ve -inf değerleri, tüm puan aralığı komutlarında geçerli puan değerleridir.

Hızlı başlangıç

Aşağıdaki örnek, iki boyutlu bir canlı yayın liderlik tablosu oluşturur: Önce popülerliğe, sonra beğeni sayısına göre sıralama yapılır.

# Add streamers with initial scores (popularity#likes)
EXZADD leaderboard 1000#500 alice 800#900 bob 1000#300 carol

# Atomically increment alice's likes without a read-modify-write cycle
EXZINCRBY leaderboard 0#100 alice

# Get the full leaderboard, highest score first
EXZREVRANGE leaderboard 0 -1 WITHSCORES
# 1) "alice"
# 2) "1000#600"
# 3) "carol"
# 4) "1000#300"
# 5) "bob"
# 6) "800#900"

# Get alice's rank (highest = rank 0)
EXZREVRANK leaderboard alice
# (integer) 0

Komutlar

Aşağıdaki tabloda tüm TairZset komutları listelenmiştir. TairZset anahtarlarını silmek için yerel Redis DEL komutunu kullanın.

Bu konuda kullanılan sözdizimi kuralları:

• BÜYÜK_HARF_ANAHTAR_SÖZCÜK: komut anahtar sözcüğü

• _italik_: değişken

• [seçenek]: isteğe bağlı parametre

• A|B: birbirini dışlayan seçenekler (birini seçin)

• ...: önceki parametre tekrarlanabilir

EXZADD

Davranış:

• Anahtar yoksa oluşturulur.

• Üye yoksa belirtilen puanla eklenir.

• Üye zaten varsa puanı üzerine yazılır (NX belirtilmedikçe).

• Her puan, çift hassasiyetli kayan noktalı bir sayının dize gösterimidir. +inf ve -inf geçerli değerlerdir.

Çok boyutlu puanlama kullanmak için her boyutu # işaretiyle ayırın; örneğin 111#222#121 . Anahtardaki tüm üyeler aynı sayıda boyut kullanmalıdır.

Seçenekler:

Dönüş değeri:

• Seçenek yoksa: Yeni eklenen üye sayısı (yalnızca puanı güncellenen üyeler sayılmaz)

• CH ile: Eklenen veya puanı değişen üye sayısı

• INCR ile: Üyenin yeni puanı dize olarak (ör. "2#0#6"); işlem NX veya XX nedeniyle atlanırsa nil döndürür

Örnek:

EXZADD testkey NX 1#0#3 a 1#0#2 b
(integer) 2

EXZINCRBY

Davranış:

• Anahtar veya üye yoksa her ikisi de oluşturulur ve puan increment değerine ayarlanır.

• Üye varsa puanı increment miktarınca artırılır.

• Her puan boyutu çift hassasiyetli kayan noktalı bir sayıdır. +inf ve -inf geçerli değerlerdir.

• Bir puanı azaltmak için negatif bir increment değeri girin.

Çok boyutlu puanlar için increment değeri, üyenin puan biçimiyle aynı olmalıdır. Örneğin, üç boyutlu bir puanın yalnızca ikinci boyutunu artırmak için 0#1#0 kullanın.

Dönüş değeri: Üyenin yeni puanı dize olarak. Çok boyutlu puanlar için biçim "score1#score2#..." şeklindedir (ör. "2#0#6").

Örnek:

EXZINCRBY testkey 2#2#1 a
"3#2#4"

EXZSCORE

Dönüş değeri: Üyenin puanı dize olarak. Çok boyutlu puanlar için biçim "score1#score2#..." şeklindedir (ör. "3#2#4").

Örnek:

EXZSCORE testkey a
"3#2#4"

EXZRANGE

Seçenekler:

Return value: Belirtilen aralıktaki üyelerin listesi; WITHSCORES belirtilirse puanlarla birlikte.

Örnek:

EXZRANGE testkey 0 -1 WITHSCORES
1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

EXZREVRANGE

Seçenekler:

Return value: Belirtilen aralıktaki üyelerin listesi; WITHSCORES belirtilirse puanlarla birlikte.

Örnek:

EXZREVRANGE testkey 0 -1 WITHSCORES
1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

EXZRANGEBYSCORE

Seçenekler:

Return value: Puan aralığındaki üyelerin listesi; WITHSCORES belirtilirse puanlarla birlikte.

Örnek:

EXZRANGEBYSCORE testkey 0#0#0 6#6#6 WITHSCORES
1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

EXZREVRANGEBYSCORE

Seçenekler:

Return value: Puan aralığındaki üyelerin listesi; WITHSCORES belirtilirse puanlarla birlikte.

Örnek:

EXZREVRANGEBYSCORE testkey 6#6#6 0#0#0 WITHSCORES
1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

EXZRANGEBYLEX

Üyelerin farklı puanları varsa döndürülen küme tanımsızdır. Sözcüksel karşılaştırma, C memcmp() işlevini kullanarak baytları tek tek karşılaştırır. İki dize ortak bir öneki paylaşıyorsa daha uzun dize daha yüksek sırada yer alır.

Seçenekler:

Return value: Sözcüksel aralıktaki üyelerin listesi.

Örnek:

EXZRANGEBYLEX zzz [a [b
1) "aba"
2) "abc"

EXZREVRANGEBYLEX

Seçenekler:

Return value: Sözcüksel aralıktaki üyelerin listesi, ters sırada.

Örnek:

EXZREVRANGEBYLEX zzz [b [a
1) "abc"
2) "aba"

EXZREM

Dönüş değeri: Kaldırılan üye sayısı (var olmayan üyeler sayılmaz).

Örnek:

EXZREM testkey a
(integer) 1

EXZREMRANGEBYSCORE

Seçenekler:

Dönüş değeri: Kaldırılan üye sayısı.

Örnek:

EXZREMRANGEBYSCORE testkey 3#2#4 6#6#6
(integer) 1

EXZREMRANGEBYRANK

Seçenekler:

Dönüş değeri: Kaldırılan üye sayısı.

Örnek:

EXZREMRANGEBYRANK testkey 0 1
(integer) 1

EXZREMRANGEBYLEX

Seçenekler:

Dönüş değeri: Kaldırılan üye sayısı.

Örnek:

EXZREMRANGEBYLEX testkey [a [b
(integer) 2

EXZCARD

Dönüş değeri: Üye sayısı (tamsayı).

Örnek:

EXZCARD testkey
(integer) 2

EXZRANK

Dönüş değeri:

• Üye varsa üyenin sırası (tamsayı)

• Anahtar veya üye yoksa nil

Örnek:

EXZRANK testkey b
(integer) 0

EXZREVRANK

Dönüş değeri:

• Üye varsa üyenin sırası (tamsayı)

• Anahtar veya üye yoksa nil

Örnek:

EXZREVRANK testkey b
(integer) 1

EXZCOUNT

Seçenekler:

Dönüş değeri: Puan aralığındaki üye sayısı (tamsayı).

Örnek:

EXZCOUNT testkey (1#0#2 6#6#6
(integer) 1

EXZLEXCOUNT

Üyelerin farklı puanları varsa sonuç tanımsızdır. Sözcüksel karşılaştırma C memcmp() işlevini kullanır. İki dize ortak bir öneki paylaşıyorsa daha uzun dize daha yüksek sırada yer alır.

Seçenekler:

Dönüş değeri: Sözcüksel aralıktaki üye sayısı (tamsayı).

Örnek:

EXZLEXCOUNT zzz [a [b
(integer) 2

EXZRANKBYSCORE

Dönüş değeri: Belirtilen puanın sırası (tamsayı).

Örnek:

EXZRANKBYSCORE testkey 2#0#2
(integer) 1

EXZREVRANKBYSCORE

Dönüş değeri: Belirtilen puanın sırası (tamsayı).

Örnek:

EXZREVRANKBYSCORE testkey 2#0#2
(integer) 1

Sonraki adımlar

• exZset kullanarak çok boyutlu liderlik tablolarını kolayca uygulama

• exZset kullanarak dağıtılmış mimari liderlik tabloları uygulama