Tair (Redis® OSS-Compatible):Roaring

Tür

Komut

Sözdizimi

Açıklama

Sürüm değişikliği

Yazma işlemi

TR.SETBIT

TR.SETBIT key offset value

Bir TairRoaring anahtarındaki belirtilen biti 1 veya 0 değerine ayarlar ve orijinal bit değerini döndürür. Ofset 0'dan başlar.

- (Yok)

TR.SETBITS

TR.SETBITS key offset [offset1 offset2 ... offsetN]

Bir TairRoaring anahtarındaki belirtilen bitin değerini 1 olarak ayarlar. Birden fazla bit değeri belirtebilirsiniz.

V2'de eklendi

TR.CLEARBITS

TR.CLEARBITS key offset [offset1 offset2 ... offsetN]

Bir TairRoaring anahtarındaki belirtilen bitin değerini 0 olarak ayarlar. Belirtilen bit zaten 0 değerine sahipse işlem gerçekleştirilmez. Birden fazla bit değeri belirtebilirsiniz.

V2'de eklendi

TR.SETRANGE

TR.SETRANGE key start end

Bir TairRoaring anahtarındaki belirtilen aralıktaki bitleri 1 değerine ayarlar. Aralık kapalı bir aralıktır.

V2'de güncellendi. V2'deki komut güncellemesinden sonra komut çıktısı, 1 olarak ayarlanan bitlerin sayısına değiştirildi.

TR.APPENDBITARRAY

TR.APPENDBITARRAY key offset bitarray

Bir bit dizisini, bir Roaring Bit Eşlemideki belirtilen bitten sonraki bir konuma ekler ve orijinal verilerin üzerine yazar. Bit dizisi 0 ve 1 değerlerinden oluşur.

V2'de eklendi

TR.FLIPRANGE

TR.FLIPRANGE key start end

Bir TairRoaring anahtarındaki belirtilen aralıktaki bitlerin değerlerini 0'dan 1'e veya 1'den 0'a değiştirir. Aralık kapalı bir aralıktır. Anahtar yoksa anahtar boş bir veri kümesi olarak oluşturulur ve işlem anahtar üzerinde gerçekleştirilir.

V2'de eklendi

TR.APPENDINTARRAY

TR.APPENDINTARRAY key value [value1 value2 ... valueN]

-

TR.SETINTARRAY

TR.SETINTARRAY key value [value1 value2 ... valueN]

-

TR.SETBITARRAY

TR.SETBITARRAY key value

-

TR.BITOP

TR.BITOP destkey operation key [key1 key2 ... keyN]

-

TR.BITOPCARD

TR.BITOPCARD operation key [key1 key2 ... keyN]

V2'de eklendi

TR.OPTIMIZE

TR.OPTIMIZE key

Bir TairRoaring anahtarının depolamasını optimize eder. Anahtar nispeten büyükse ve oluşturulduktan sonra öncelikle okuma işlemleri için kullanılıyorsa bu komutu çalıştırabilirsiniz.

-

Okuma işlemi

TR.GETBIT

TR.GETBIT key offset

Bir TairRoaring anahtarından belirtilen bitin değerini alır.

-

TR.GETBITS

TR.GETBITS key offset [offset1 offset2 ... offsetN]

Bir TairRoaring anahtarından belirtilen bitin değerini alır. Değer almak için birden fazla bit belirtebilirsiniz.

V2'de eklendi

TR.BITCOUNT

TR.BITCOUNT key [start end]

Bir TairRoaring anahtarındaki belirtilen aralıktaki 1 değerine sahip bitlerin sayısını hesaplar. Aralık kapalı bir aralıktır.

V2 ve ileriye dönük uyumlulukta güncellendi.

TR.BITPOS

TR.BITPOS <key> <value> [count]

Sıra numarası count olan bitin ofsetini alır. Bir bitin değeri 1 veya 0 olabilir. Count parametresi isteğe bağlıdır ve varsayılan değeri 1'dir. 1 değeri, soldan sağa sayma yaklaşımı kullanılarak alınan ilk biti gösterir.

V2'de güncellendi ve ileriye dönük uyumlu.

TR.SCAN

TR.SCAN key start_offset [COUNT count]

V2'de eklendi

TR.RANGE

TR.RANGE key start end

Bir TairRoaring anahtarındaki belirtilen aralıktaki 1 değerine sahip bitlerin ofsetlerini döndürür. Aralık kapalı bir aralıktır.

V1'deki TR.RANGEINTARRAY'den V2'de TR.RANGE olarak yeniden adlandırıldı.

TR.RANGEBITARRAY

TR.RANGEBITARRAY key start end

Bir TairRoaring anahtarındaki belirtilen aralıktaki 0 ve 1 bit değerlerinden oluşan bir dizeyi alır. Aralık kapalı bir aralıktır.

V2'de eklendi

TR.MIN

TR.MIN key

Bir TairRoaring anahtarında 1 değerine sahip ilk bitin ofsetini alır. Hiçbir bitin değeri 1 değilse -1 değeri döndürülür.

-

TR.MAX

TR.MAX key

Bir Roaring Bit Eşleminde 1 değerine sahip son bitin ofsetini alır. Hiçbir bitin değeri 1 değilse -1 döndürülür.

-

TR.STAT

TR.STAT key [JSON]

Belirtilen TairRoaring anahtarının istatistiksel bilgilerini döndürür. Bilgiler, konteyner sayısını ve bellek kullanımını içerir.

V2'de eklendi

TR.JACCARD

TR.JACCARD key1 key2

V2.2'de eklendi

TR.CONTAINS

TR.CONTAINS key1 key2

V2.2'de eklendi

TR.RANK

TR.RANK key offset

İlk bitten belirtilen bite kadar olan aralıktaki 1 değerine sahip bitlerin sayısını alır. Aralık kapalı bir aralıktır.

V2.2'de eklendi

Genel amaçlı işlem

DEL

DEL key [key ...]

Bir veya daha fazla TairRoaring anahtarını siler.

-

Kategori

Açıklama

Sözdizimi

TR.SETBIT key offset value

Zaman karmaşıklığı

O(1)

Komut açıklaması

Bir TairRoaring anahtarındaki belirtilen biti 1 veya 0 değerine ayarlar ve orijinal bit değerini döndürür. Ofset 0'dan başlar.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Ayarlanacak bitin ofsetini temsil eden, değer aralığı 0 ~ 2^32 olan bir tamsayı.

• value: Ayarlanacak bit değeri; 1 veya 0 olabilir.

Çıktı

• İşlem başarılı olursa 0 veya 1 bit değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.SETBIT foo 0 1

Örnek çıktı:

(integer) 0

Öğe

Açıklama

Sözdizimi

TR.SETBITS key offset [offset1 offset2 ... offsetN]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarındaki belirtilen bitin değerini 1 olarak ayarlar. Birden fazla bit değeri belirtebilirsiniz.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Ayarlanacak bitin ofsetini temsil eden, değer aralığı 0 ~ 2^32 olan bir tamsayı.

Çıktı

• İşlem başarılı olursa anahtardaki 1 olarak ayarlanan bitlerin sayısı döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.SETBITS foo 9 10

Örnek çıktı:

(integer) 5

Öğe

Açıklama

Sözdizimi

TR.CLEARBITS key offset [offset1 offset2 ... offsetN]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarındaki belirtilen bitin değerini 0 olarak ayarlar. Belirtilen bit zaten 0 değerine sahipse işlem gerçekleştirilmez. Birden fazla bit değeri belirtebilirsiniz.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Ayarlanacak bitin ofsetini temsil eden, değer aralığı 0 ~ 2^32 olan bir tamsayı.

Çıktı

• İşlem başarılı olursa anahtardaki 0 olarak ayarlanan bitlerin sayısı döndürülür.

• Anahtar yoksa 0 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.CLEARBITS foo 9 10

Örnek çıktı:

(integer) 2

Öğe

Açıklama

Sözdizimi

TR.SETRANGE key start end

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarındaki belirtilen aralıktaki bitleri 1 değerine ayarlar. Aralık kapalı bir aralıktır.

Örneğin, TR.SETRANGE foo 1 3 komutunu çalıştırırsanız sistem 0111 foo anahtarını oluşturur.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

• start: Aralığın başlangıç değeri. Geçerli değerler: 0 ila 2^32.

• end: Aralığın bitiş değeri. Geçerli değerler: 0 ila 2^32.

Çıktı

• İşlem başarılı olursa anahtardaki 1 olarak ayarlanan bitlerin sayısı döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.SETRANGE foo 1 3

Örnek çıktı:

(integer) 3

Öğe

Açıklama

Sözdizimi

TR.APPENDBITARRAY key offset bitarray

Zaman karmaşıklığı

O(C)

Komut açıklaması

Belirtilen bitten sonraki bir konuma, Roaring Bitmap içine bir bit dizisi ekler ve orijinal verilerin üzerine yazar. Bit dizisi 0 ve 1 değerlerinden oluşur.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Belirtilen başlangıç ofseti (bu değer dahil değildir), değer aralığı -1 ~ 2^32'dir.

• bitarray: Eklenecek bit dizisi; mevcut verilerin üzerine yazar ve ardışık 0 veya 1 değerlerinden oluşur. Değer aralığı 0 ~ 2^32'dir.

  Not

  Belirtilen ofset ile eklenen bitarray'in toplam uzunluğu 2^32 değerini aşamaz, aksi takdirde işlem başarısız olur.

Çıktı

• İşlem başarılı olursa, anahtarda 1 olarak ayarlanan bit sayısı döndürülür.

• Aksi takdirde, bir hata mesajı döndürülür.

Örnek

Önceden TR.SETBITS foo 0 komutunu çalıştırın.

Örnek komut:

TR.APPENDBITARRAY foo 1 1101

Örnek çıktı:

(integer) 4

Bu durumda, TairRoaring foo anahtarı "101101" değerindedir.

Öğe

Açıklama

Sözdizimi

TR.FLIPRANGE key start end

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarındaki belirtilen aralıktaki bitlerin değerlerini 0'dan 1'e veya 1'den 0'a değiştirir. Aralık kapalı bir aralıktır. Anahtar yoksa, anahtar boş bir veri kümesi olarak oluşturulur ve işlem bu anahtar üzerinde gerçekleştirilir.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• start: Başlangıç ofseti (dahil), değerler 0 ila 2^32 arasındadır.

• end: Bitiş ofseti (dahil), değerler 0 ila 2^32 arasındadır.

Çıktı

• İşlem başarılı olursa, anahtarda 1 olarak ayarlanan bit sayısı döndürülür.

• Anahtar yoksa, anahtar boş bir veri kümesi olarak oluşturulur ve işlem bu anahtar üzerinde gerçekleştirilir. İşlem başarılı olursa, anahtarda 1 olarak ayarlanan bit sayısı döndürülür.

• Aksi takdirde, bir hata mesajı döndürülür.

Örnek

Önceden TR.SETBITS foo 0 2 3 5 komutunu çalıştırın.

Örnek komut:

TR.FLIPRANGE foo 0 5

Örnek çıktı:

(integer) 2

Bu durumda, TairRoaring foo anahtarı "01001" değerindedir.

Öğe

Açıklama

Sözdizimi

TR.APPENDINTARRAY key value [value1 value2 ... valueN]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• value: İşlemek istediğiniz bitin tamsayı ofseti. Geçerli değerler: 0 ila 4294967296.

Çıktı

• İşlem başarılı olursa, OK döndürülür.

• Aksi takdirde, bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.APPENDINTARRAY foo 9 10

Örnek çıktı:

OK

Öğe

Açıklama

Sözdizimi

TR.SETINTARRAY key value [value1 value2 ... valueN]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• value: Ayarlanacak bit konumunu belirten bir tamsayı.

Çıktı

• İşlem başarılı olursa, OK döndürülür.

• Aksi takdirde, bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.SETINTARRAY foo 2 4 5 6

Örnek çıktı:

OK

Öğe

Açıklama

Sözdizimi

TR.SETBITARRAY key value

Zaman karmaşıklığı

O(C)

Komut açıklaması

Parametre

• key: Bu komutu çalıştırarak yönetmek istediğiniz anahtar.

• value: Bit dizisini temsil eden 0 ve 1'lerden oluşan bir dize.

Çıktı

• İşlem başarılı olursa: OK döndürülür.

• Aksi takdirde, bir hata mesajı döndürülür.

Örnek

Örnek komut:

tr.setbitarray foo 10101001

Örnek çıktı:

OK 

Öğe

Açıklama

Sözdizimi

TR.BITOP destkey operation key [key1 key2 ... keyN]

Zaman karmaşıklığı

O(C * M)

Komut açıklaması

Seçenekler

• destkey: Sonucun saklandığı hedef anahtar (TairRoaring veri yapısı).

• operation: Küme işlemi türü. Geçerli değerler: AND (mantıksal VE), OR (mantıksal VEYA), XOR (özel VEYA), NOT (mantıksal DEĞİL) ve DIFF (fark).

  Not

  • NOT işlemleri yalnızca tek bir anahtar üzerinde gerçekleştirilebilir.

  • DIFF işlemleri yalnızca iki anahtar üzerinde gerçekleştirilebilir. Anahtarların sırasına dikkat edin. Örneğin, TR.BITOP result DIFF key1 key2 komutu key2 değerini key1 değerinden çıkarır (key1 - key2).

• key: TairRoaring veri yapısının anahtarı. Birden fazla anahtar belirtebilirsiniz.

Çıktı

• İşlem başarılı olursa sonuçta 1 olarak ayarlanmış bitlerin tamsayı sayısı döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.BITOP result OR foo bar

Örnek çıktı:

(integer) 6

Öğe

Açıklama

Sözdizimi

TR.BITOPCARD operation key [key1 key2 ... keyN]

Zaman karmaşıklığı

O(C * M)

Komut açıklaması

seçenekler

• operation: Küme işlemi türü. Geçerli değerler: AND, OR, XOR, NOT ve DIFF.

  Not

  • NOT işlemleri yalnızca tek bir anahtar üzerinde gerçekleştirilebilir.

  • DIFF işlemleri yalnızca iki anahtar arasındaki farkı hesaplayabilir. Fark hesaplarken işlem sırasına dikkat edin. Örneğin, TR.BITOP result DIFF key1 key2 komutu key1'in key2'ye göre farkını hesaplar (key1 - key2).

• key: Anahtar adı (TairRoaring veri yapısı). Birden fazla anahtar belirtebilirsiniz.

Çıktı

• İşlem başarılı olursa sonuçta 1 olarak ayarlanmış bitlerin tamsayı sayısı döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.BITOPCARD NOT foo

Örnek çıktı:

(integer) 2

Öğe

Açıklama

Sözdizimi

TR.OPTIMIZE key

Zaman karmaşıklığı

O(M)

Komut açıklaması

Bir TairRoaring anahtarının depolamasını optimize eder. Anahtar nispeten büyükse ve oluşturulduktan sonra ağırlıklı olarak okuma işlemleri için kullanılıyorsa bu komutu çalıştırabilirsiniz.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

Çıktı

• İşlem başarılı olursa OK döndürülür.

• Anahtar mevcut değilse nil döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.OPTIMIZE foo

Örnek çıktı:

OK

Öğe

Açıklama

Sözdizimi

TR.GETBIT key offset

Zaman karmaşıklığı

O(1)

Komut açıklaması

Bir TairRoaring anahtarından belirtilen bitin değerini alır.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Sorgulamak istediğiniz ofset.

Çıktı

• İşlem başarılı olursa 0 veya 1 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.GETBIT foo 0

Örnek çıktı:

(integer) 1

Öğe

Açıklama

Sözdizimi

TR.GETBITS key offset [offset1 offset2 ... offsetN]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarından belirtilen bitin değerini alır. Değer almak için birden fazla bit belirtebilirsiniz.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Sorgulamak istediğiniz ofset.

Çıktı

• İşlem başarılı olursa bit değeri döndürülür.

• Anahtar mevcut değilse boş bir dizi döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.GETBITS foo 3 4 6 8

Örnek çıktı:

1) (integer) 1
2) (integer) 1
3) (integer) 1
4) (integer) 0

Öğe

Açıklama

Sözdizimi

TR.BITCOUNT key [start end]

Zaman karmaşıklığı

O(M)

Komut açıklaması

Bir TairRoaring anahtarında belirtilen aralıkta değeri 1 olan bitlerin sayısını hesaplar. Aralık kapalı bir aralıktır.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• start: Başlangıç ofseti (dahil), değerler 0 ile 2^32 arasında değişir.

• end: Bitiş ofseti (dahil), değerler 0 ile 2^32 arasında değişir.

Çıktı

• İşlem başarılı olursa anahtarda 1 olarak ayarlanmış bitlerin tamsayı sayısı döndürülür.

• Anahtar mevcut değilse 0 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.BITCOUNT foo 4 9

Örnek çıktı:

(integer) 3

Öğe

Açıklama

Sözdizimi

TR.BITPOS <key> <value> [count]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Ordinal numarası count olan bitin ofsetini alır. Bir bitin değeri 1 veya 0 olabilir. count parametresi isteğe bağlıdır ve varsayılan değeri 1'dir. 1 değeri, soldan sağa doğru sayma yaklaşımı kullanılarak alınan ilk biti gösterir.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• value: Ofsetini almak istediğiniz bitin değeri. Bit değeri 0 veya 1 olabilir.

• count: Bitin ordinal numarası. Negatif bir sayı, sağdan sola doğru sayma yaklaşımının kullanıldığını gösterir.

Çıktı

• İşlem başarılı olursa değeri 1 veya 0 olan bitin ofseti döndürülür.

• Anahtar mevcut değilse -1 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.BITPOS foo 1 -1

Örnek çıktı:

(integer) 6

Öğe

Açıklama

Sözdizimi

TR.SCAN key start_offset [COUNT count]

Zaman karmaşıklığı

O(C)

Komut açıklaması

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• start_offset: Bitin ofseti. Bu ofsetle eşleşen bit taranır.

• COUNT: Sorgulamak istediğiniz bit sayısı. Varsayılan değer: 10.

Çıktı

• İşlem başarılı olursa iki öğe içeren bir dizi döndürülür:

  • İlk öğe sonraki start_offset değeridir. Anahtar taranırsa 0 değeri döndürülür.

  • İkinci öğe: Geçerli sorgunun hedef ofseti.

  Not

  Anahtar mevcut değilse 0 ve boş öğelerden oluşan bir dizi döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.SCAN foo 0 COUNT 2

Örnek çıktı:

1) (integer) 3
2) 1) (integer) 0
   2) (integer) 2

Kategori

Açıklama

Sözdizimi

TR.RANGE key start end

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarında belirtilen aralıkta değeri 1 olan bitlerin ofsetlerini döndürür. Aralık kapalı bir aralıktır.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• start: Aralığın başlangıç değeri (dahil).

• end: Aralığın bitiş değeri (dahil).

Çıktı

• İşlem başarılı olursa değeri 1 olan bitlerin ofsetleri döndürülür.

• Anahtar mevcut değilse boş bir dizi döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Öncesinde TR.SETBITS foo 0 2 3 5 komutunu çalıştırın.

Örnek komut:

TR.RANGE foo 0 5

Örnek çıktı:

1) (integer) 0
2) (integer) 2
3) (integer) 3
4) (integer) 5

Öğe

Açıklama

Sözdizimi

TR.RANGEBITARRAY key start end

Zaman karmaşıklığı

O(C)

Komut açıklaması

Bir TairRoaring anahtarında belirtilen aralıkta 0 ve 1 bit değerlerinden oluşan bir dizeyi alır. Aralık kapalı bir aralıktır.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• start: Aralığın başlangıç değeri (dahil).

• end: Aralığın bitiş değeri (dahil).

Çıktı

• İşlem başarılı olursa değeri 1 olan bitlerin ofsetleri döndürülür.

• Anahtar mevcut değilse nil döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Öncesinde TR.SETBITS foo 0 2 3 5 komutunu çalıştırın.

Örnek komut:

TR.RANGEBITARRAY foo 0 5

Örnek çıktı:

"101101"

Öğe

Açıklama

Sözdizimi

TR.MIN key

Zaman karmaşıklığı

O(1)

Komut açıklaması

Bir TairRoaring anahtarında değeri 1 olan ilk bitin ofsetini alır. Hiçbir bitin değeri 1 değilse -1 değeri döndürülür.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

Çıktı

• İşlem başarılı olursa:

  • Anahtarda değeri 1 olan bitler varsa değeri 1 olan ilk bitin tamsayı ofseti döndürülür.

  • Anahtarda değeri 1 olan bit yoksa veya anahtar mevcut değilse -1 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.MIN foo

Örnek çıktı:

4

Öğe

Açıklama

Sözdizimi

TR.MAX key

Zaman karmaşıklığı

O(1)

Komut açıklaması

Bir Roaring Bitmap'te değeri 1 olan son bitin ofsetini alır. Hiçbir bitin değeri 1 değilse -1 döndürülür.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

Çıktı

• İşlem başarılı olursa:

  • Anahtarda değeri 1 olan bitler varsa değeri 1 olan son bitin tamsayı ofseti döndürülür.

  • Anahtarda değeri 1 olan bit yoksa veya anahtar mevcut değilse -1 değeri döndürülür.

• Aksi takdirde bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.MAX foo

Örnek çıktı:

6

Öğe

Açıklama

Sözdizimi

TR.STAT key [JSON]

Zaman karmaşıklığı

O(M)

Komut açıklaması

Belirtilen TairRoaring anahtarının istatistiksel bilgilerini döndürür. Bu bilgiler, konteyner sayısını ve bellek kullanımını içerir.

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

• JSON: Bu parametre belirtilirse istatistik bilgileri JSON biçiminde döndürülür.

Çıktı

• İşlem başarılı olursa aşağıdaki çıktı döndürülür:

  "{\"cardinality\":3,                    # Total number of elements in the key
  \"number_of_containers\":1,             # Total number of containers in the key
  \"max_value\":6,                        # Maximum element value in the key
  \"min_value\":3,                        # Minimum element value in the key
  \"sum_value\":13,
  \"array_container\":{                   # Number of array containers in the key
      \"number_of_containers\":1,
      \"container_cardinality\":3,
      \"container_allocated_bytes\":6},
  \"bitset_container\":{                  # Number of bitset containers in the key
      \"number_of_containers\":0,
      \"container_cardinality\":0,
      \"container_allocated_bytes\":0},
  \"run_container\":{                     # Number of run containers in the key
      \"number_of_containers\":0,
      \"container_cardinality\":0,
      \"container_allocated_bytes\":0}}"
  
                                          

• Anahtar mevcut değilse nil döndürülür.

• Diğer durumlarda bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.STAT foo JSON

Örnek çıktı:

"{\"cardinality\":4,\"number_of_containers\":1,\"max_value\":5,\"min_value\":0,\"sum_value\":10,\"array_container\":{\"number_of_containers\":1,\"container_cardinality\":4,\"container_allocated_bytes\":8},\"bitset_container\":{\"number_of_containers\":0,\"container_cardinality\":0,\"container_allocated_bytes\":0},\"run_container\":{\"number_of_containers\":0,\"container_cardinality\":0,\"container_allocated_bytes\":0}}"

Öğe

Açıklama

Sözdizimi

TR.JACCARD key1 key2

Zaman karmaşıklığı

O(M)

Komut açıklaması

Parametre

• Key: Anahtar adı (TairRoaring veri yapısı).

Çıktı

• İşlem başarılı olursa double türünde bir Jaccard benzerlik katsayısı döndürülür.

• Diğer durumlarda bir hata mesajı döndürülür.

Örnek

Örnek komut:

TR.JACCARD foo1 foo2

Örnek çıktı:

"0.20000000000000001"

Kategori

Açıklama

Sözdizimi

TR.CONTAINS key1 key2

Zaman karmaşıklığı

O(M)

Komut açıklaması

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

Çıktı

• İşlem başarılı olursa:

  • key2, key1'i içeriyorsa 1 değeri döndürülür.

  • key2, key1'i içermiyorsa 0 değeri döndürülür.

• Diğer durumlarda bir hata mesajı döndürülür.

Örnek

Önceden TR.SETBITS fooM 1 2 3 10 ve TR.SETBITS foom 1 2 komutlarını çalıştırın.

Örnek komut:

TR.CONTAINS foom fooM

Örnek çıktı:

(integer) 1

Öğe

Açıklama

Sözdizimi

TR.RANK key offset

Zaman karmaşıklığı

O(M)

Komut açıklaması

İlk bitten belirtilen bite kadar olan aralıktaki (kapalı aralık) 1 değerine sahip bitlerin sayısını alır.

Seçenekler

• Key: Anahtar adı (TairRoaring veri yapısı).

• offset: Belirtilen bitin ofseti. Değer bir tamsayı olmalıdır.

Çıktı

• İşlem başarılı olursa 1 değerine sahip bitlerin sayısı döndürülür.

• Diğer durumlarda bir hata mesajı döndürülür.

Örnek

Önceden TR.SETBITS fooM 1 2 3 10 komutunu çalıştırın.

Örnek komut:

TR.RANK fooM 10

Örnek çıktı:

(integer) 4

Hata mesajı

Açıklama

WRONGTYPE Operation against a key holding the wrong kind of value

Yanlış nesne türü: Anahtar bir TairRoaring nesnesi değil.

ERR bad arguments, must be unsigned 32-bit integer

Yanlış parametre türü: Parametre değerleri 32 bitlik tamsayılara dönüştürülemiyor.

ERR invalid arguments, maybe out of range or illegal

Geçersiz parametreler:

• Ofset 32 bitlik bir tamsayı değil.

• Başlangıç ve bitiş ofsetleri geçersiz.

• Parametre değeri, bir TairRoaring anahtarı için izin verilen maksimum öğe sayısını aşıyor.

ERR key already exist

TairRoaring anahtarı zaten mevcut ve verileri üzerine yazılamıyor.

ERR key not found

Roaring Bitmap nesnesi mevcut değil. Bu işlem desteklenmiyor.