TairRoaring et ses commandes prises en charge - Tair (Redis® OSS-Compatible)

Présentation de TairRoaring

Le bitmap (également appelé bitset) est une structure de données courante qui optimise les requêtes sur de grands volumes de données tout en occupant peu d'espace mémoire. Les bitmaps consomment moins d'espace que les implémentations basées sur des tables de hachage, mais ils ne conviennent pas au stockage de données clairsemées. Les bitmaps compressés ont été développés pour répondre à cette problématique. Les bitmaps Roaring constituent un type de bitmap reconnu par l'industrie, offrant un meilleur équilibre et une plus grande efficacité que les autres formats de bitmaps compressés.

TairRoaring optimise les bitmaps Roaring de plusieurs manières :

Grâce à l'utilisation d'index à deux niveaux et de conteneurs dynamiques, TairRoaring parvient à équilibrer les performances et la complexité spatiale dans de nombreux scénarios.
TairRoaring intègre des techniques d'optimisation telles que le traitement SIMD (Single Instruction, Multiple Data), la vectorisation et les algorithmes popcount. Ces améliorations accroissent l'efficacité du calcul et garantissent une complexité temporelle et spatiale optimale.
TairRoaring s'appuie sur la puissance de calcul et la stabilité élevée offertes par Tair pour répondre aux exigences des scénarios métier.

Scénarios typiques

TairRoaring convient particulièrement aux secteurs du streaming en direct, de la musique et du commerce électronique. Vous pouvez l'utiliser pour ajouter des tags multidimensionnels aux utilisateurs, afin de mettre en place des recommandations personnalisées ou des campagnes de marketing ciblé.

Notes de version

Important

Évolutions apportées par TairRoaring V2 :

TR.RANGEINTARRAY : la commande TR.RANGEINTARRAY de TairRoaring V1 devient TR.RANGE dans TairRoaring V2.
TR.SETRANGE : dans la version V1, cette commande renvoie OK ; dans la version V2, elle retourne le nombre de bits définis à 1. Le reste du comportement de la commande demeure inchangé.

Le 13 septembre 2021, TairRoaring V1 a été publié pour les instances exécutant la version mineure 1.7.20 ou ultérieure.
Le 11 mars 2022, TairRoaring V2 a été publié pour les instances exécutant la version mineure 1.7.27 ou ultérieure.

TairRoaring V2 optimise l'implémentation de certaines commandes et améliore leurs performances. Cette version introduit neuf nouvelles commandes, dont TR.SETBITS et TR.CLEARBITS, met à jour trois commandes (dont deux restent compatibles avec TairRoaring V1) et renomme une commande.
Le 20 avril 2022, TairRoaring V2.2 a été publié pour les instances exécutant la version mineure 1.8.1 ou ultérieure.

Cette version ajoute les commandes TR.JACCARD, TR.CONTAINS et TR.RANK, et modifie les erreurs renvoyées par certaines commandes lorsqu'une clé n'existe pas (l'erreur ERR key not found est supprimée).

Bonnes pratiques

Segmentation d'audience avec TairRoaring

Prérequis

L'instance doit être une instance Tair optimisée pour la mémoire. Si votre instance optimisée pour la mémoire est compatible avec Redis 5.0, sa version mineure doit être égale ou supérieure à 1.7.7.

Remarque

La dernière version mineure offre davantage de fonctionnalités et une stabilité accrue. Nous vous recommandons de mettre à jour votre instance vers la dernière version mineure. Pour plus d'informations, consultez la rubrique Mettre à jour la version mineure d'une instance. Si votre instance est configurée en mode cluster ou en lecture/écriture séparée, nous vous conseillons également de mettre à jour les nœuds proxy vers la dernière version mineure afin de garantir le bon fonctionnement de toutes les commandes.

Remarques importantes

Les opérations décrites s'appliquent aux données TairRoaring stockées dans une instance Tair.

Liste des commandes

Type	Commande	Syntaxe	Description	Évolution de version
Opération d'écriture	TR.SETBIT	`TR.SETBIT key offset value`	Définit la valeur d'un bit spécifique d'une clé TairRoaring à 1 ou 0, et renvoie la valeur originale du bit. L'offset commence à 0.	- (S/O)
	TR.SETBITS	`TR.SETBITS key offset [offset1 offset2 ... offsetN]`	Définit la valeur des bits spécifiés d'une clé TairRoaring à 1. Vous pouvez indiquer plusieurs positions de bits.	Ajoutée dans la version V2
	TR.CLEARBITS	`TR.CLEARBITS key offset [offset1 offset2 ... offsetN]`	Définit la valeur des bits spécifiés d'une clé TairRoaring à 0. Si le bit indiqué vaut déjà 0, l'opération n'est pas effectuée. Vous pouvez spécifier plusieurs positions de bits.	Ajoutée dans la version V2
	TR.SETRANGE	`TR.SETRANGE key start end`	Définit tous les bits compris dans une plage donnée d'une clé TairRoaring à 1. La plage est un intervalle fermé.	Mise à jour dans la version V2. Après cette mise à jour, la commande renvoie le nombre de bits définis à 1.
	TR.APPENDBITARRAY	`TR.APPENDBITARRAY key offset bitarray`	Insère un tableau de bits après la position spécifiée dans un bitmap Roaring, en écrasant les données originales. Le tableau de bits est composé de 0 et de 1.	Ajoutée dans la version V2
	TR.FLIPRANGE	`TR.FLIPRANGE key start end`	Inverse les valeurs des bits situés dans la plage spécifiée d'une clé TairRoaring (0 devient 1, et 1 devient 0). La plage est un intervalle fermé. Si la clé n'existe pas, elle est créée comme un ensemble de données vide avant l'exécution de l'opération.	Ajoutée dans la version V2
	TR.APPENDINTARRAY	`TR.APPENDINTARRAY key value [value1 value2 ... valueN]`	Définit la valeur des bits spécifiés d'une clé TairRoaring à 1. Vous pouvez indiquer plusieurs positions de bits. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.SETBITS plutôt que cette commande.	-
	TR.SETINTARRAY	`TR.SETINTARRAY key value [value1 value2 ... valueN]`	Crée une clé TairRoaring à partir du tableau d'entiers fourni. Si la clé existe déjà, cette commande écrase les données qu'elle contient. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.SETBITS plutôt que cette commande.	-
	TR.SETBITARRAY	`TR.SETBITARRAY key value`	Crée une clé TairRoaring à partir de la chaîne de bits fournie (composée de 0 et de 1). Si la clé existe déjà, cette commande écrase les données qu'elle contient. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.APPENDBITARRAY plutôt que cette commande.	-
	TR.BITOP	`TR.BITOP destkey operation key [key1 key2 ... keyN]`	Effectue des opérations ensemblistes sur des bitmaps Roaring et stocke le résultat dans la clé destkey. Les opérations AND, OR, XOR, NOT et DIFF sont prises en charge. Remarque Cette commande n'est pas disponible pour les clés réparties sur différents slots dans les instances cluster.	-
	TR.BITOPCARD	`TR.BITOPCARD operation key [key1 key2 ... keyN]`	Effectue une opération bit à bit sur plusieurs clés TairRoaring. Les opérations bit à bit AND, OR, XOR, NOT et DIFF sont prises en charge. Remarque Cette commande n'est pas disponible pour les clés réparties sur différents slots dans les instances cluster.	Ajoutée dans la version V2
	TR.OPTIMIZE	`TR.OPTIMIZE key`	Optimise le stockage d'une clé TairRoaring. Utilisez cette commande si la clé est relativement volumineuse et destinée principalement à des opérations de lecture après sa création.	-
Opération de lecture	TR.GETBIT	`TR.GETBIT key offset`	Récupère la valeur du bit spécifié dans une clé TairRoaring.	-
	TR.GETBITS	`TR.GETBITS key offset [offset1 offset2 ... offsetN]`	Récupère la valeur des bits spécifiés dans une clé TairRoaring. Vous pouvez indiquer plusieurs positions de bits.	Ajoutée dans la version V2
	TR.BITCOUNT	`TR.BITCOUNT key [start end]`	Compte le nombre de bits définis à 1 dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.	Mise à jour dans la version V2 et rétrocompatible.
	TR.BITPOS	`TR.BITPOS <key> <value> [count]`	Récupère l'offset du bit dont le rang ordinal correspond à la valeur count. Un bit peut valoir 1 ou 0. Le paramètre count est facultatif et vaut 1 par défaut. Une valeur de 1 indique le premier bit trouvé selon un parcours de gauche à droite.	Mise à jour dans la version V2 et rétrocompatible.
	TR.SCAN	`TR.SCAN key start_offset [COUNT count]`	Parcourt tous les bits situés après une position donnée dans une clé TairRoaring, et renvoie les offsets correspondant à un nombre donné de bits valant 1. Le curseur renvoyé correspond à l'offset associé à la clé. Remarque Cette commande peut inclure ou exclure les éléments ajoutés ou supprimés lors du parcours.	Ajoutée dans la version V2
	TR.RANGE	`TR.RANGE key start end`	Renvoie les offsets des bits valant 1 dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.	Renommée TR.RANGE dans la version V2 (auparavant TR.RANGEINTARRAY dans la version V1).
	TR.RANGEBITARRAY	`TR.RANGEBITARRAY key start end`	Récupère une chaîne composée des valeurs de bits (0 et 1) situés dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.	Ajoutée dans la version V2
	TR.MIN	`TR.MIN key`	Récupère l'offset du premier bit valant 1 dans une clé TairRoaring. Si aucun bit ne vaut 1, la commande renvoie -1.	-
	TR.MAX	`TR.MAX key`	Récupère l'offset du dernier bit valant 1 dans un bitmap Roaring. Si aucun bit ne vaut 1, la commande renvoie -1.	-
	TR.STAT	`TR.STAT key [JSON]`	Renvoie les informations statistiques relatives à la clé TairRoaring spécifiée, notamment le nombre de conteneurs et l'utilisation mémoire.	Ajoutée dans la version V2
	TR.JACCARD	`TR.JACCARD key1 key2`	Calcule le coefficient de similarité de Jaccard entre deux clés TairRoaring. Plus le coefficient est élevé, plus la similarité est forte. Remarque Cette commande n'est pas disponible pour les clés réparties sur différents slots dans les instances cluster.	Ajoutée dans la version V2.2
	TR.CONTAINS	`TR.CONTAINS key1 key2`	Vérifie si key2 contient key1. Si c'est le cas, key1 est un sous-ensemble de key2 et la commande renvoie 1. Sinon, key1 n'est pas un sous-ensemble de key2 et la commande renvoie 0. Remarque Cette commande n'est pas disponible pour les clés réparties sur différents slots dans les instances cluster.	Ajoutée dans la version V2.2
	TR.RANK	`TR.RANK key offset`	Récupère le nombre de bits valant 1 compris entre le premier bit et le bit spécifié. La plage est un intervalle fermé.	Ajoutée dans la version V2.2
Opération générique	DEL	`DEL key [key ...]`	Supprime une ou plusieurs clés TairRoaring.	-

Remarque

La section suivante décrit la syntaxe des commandes :
- Mot-clé en majuscules : indique un mot-clé de commande.
- Texte en italique : indique une variable.
- [options] : indique que les paramètres entre crochets sont facultatifs. Les paramètres non entourés de crochets sont obligatoires.
- A|B : indique que les paramètres séparés par une barre verticale (|) s'excluent mutuellement. Vous ne pouvez spécifier qu'un seul de ces paramètres.
- ... : indique que le paramètre précédant ce symbole peut être répété.
Dans cette rubrique, les lettres utilisées dans les expressions de complexité temporelle ont les significations suivantes :
- C représente argc ou la plage de paramètres.
- M représente le nombre de bits définis à 1 dans une structure de données, par exemple le nombre de nœuds dans une liste ou le nombre de champs dans un hash.

TR.SETBIT

Catégorie	Description
Syntaxe	`TR.SETBIT key offset value`
Complexité temporelle	O(1)
Description de la commande	Définit la valeur d'un bit spécifique d'une clé TairRoaring à 1 ou 0, et renvoie la valeur originale du bit. L'offset commence à 0.
Paramètre	Key : nom de la clé (structure de données TairRoaring). offset : entier représentant l'offset du bit à définir. Plage de valeurs : 0 à 2^32. value : valeur du bit à définir (1 ou 0).
Sortie	En cas de succès, la commande renvoie la valeur du bit (0 ou 1). Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.SETBIT foo 0 1` Exemple de sortie : `(integer) 0`

TR.SETBITS

Élément	Description
Syntaxe	`TR.SETBITS key offset [offset1 offset2 ... offsetN]`
Complexité temporelle	O(C)
Description de la commande	Définit la valeur des bits spécifiés d'une clé TairRoaring à 1. Vous pouvez indiquer plusieurs positions de bits.
Options	Key : nom de la clé (structure de données TairRoaring). offset : entier représentant l'offset du bit à définir. Plage de valeurs : 0 à 2^32.
Sortie	En cas de succès, la commande renvoie le nombre de bits de la clé définis à 1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.SETBITS foo 9 10` Exemple de sortie : `(integer) 5`

TR.CLEARBITS

Élément	Description
Syntaxe	`TR.CLEARBITS key offset [offset1 offset2 ... offsetN]`
Complexité temporelle	O(C)
Description de la commande	Définit la valeur des bits spécifiés d'une clé TairRoaring à 0. Si le bit indiqué vaut déjà 0, l'opération n'est pas effectuée. Vous pouvez spécifier plusieurs positions de bits.
Paramètre	Key : nom de la clé (structure de données TairRoaring). offset : entier représentant l'offset du bit à définir. Plage de valeurs : 0 à 2^32.
Sortie	En cas de succès, la commande renvoie le nombre de bits de la clé définis à 0. Si la clé n'existe pas, la commande renvoie 0. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.CLEARBITS foo 9 10` Exemple de sortie : `(integer) 2`

TR.SETRANGE

Élément	Description
Syntaxe	`TR.SETRANGE key start end`
Complexité temporelle	O(C)
Description de la commande	Définit tous les bits compris dans une plage donnée d'une clé TairRoaring à 1. La plage est un intervalle fermé. Par exemple, si vous exécutez la commande `TR.SETRANGE foo 1 3`, le système crée la clé foo avec la valeur 0111.
Options	Key : nom de la clé (structure de données TairRoaring). start : valeur de début de l'intervalle. Valeurs valides : 0 à 2^32. end : valeur de fin de l'intervalle. Valeurs valides : 0 à 2^32.
Sortie	En cas de succès, la commande renvoie le nombre de bits de la clé définis à 1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.SETRANGE foo 1 3` Exemple de sortie : `(integer) 3`

TR.APPENDBITARRAY

Item	Description
Syntaxe	`TR.APPENDBITARRAY key offset bitarray`
Complexité temporelle	O(C)
Description de la commande	Insère un tableau de bits à une position située après le bit spécifié dans un Roaring Bitmap et écrase les données d'origine. Le tableau de bits est composé de 0 et de 1.
Paramètre	Key : nom de la clé (structure de données TairRoaring). offset : décalage de départ spécifié (cette valeur n'est pas incluse), avec une plage de valeurs allant de -1 à 2^32. bitarray : tableau de bits à ajouter, qui écrasera les données existantes. Il est constitué de 0 ou de 1 consécutifs, avec une plage de valeurs allant de 0 à 2^32. Remarque La longueur totale du décalage spécifié et du tableau de bits ajouté ne peut pas dépasser 2^32, sinon l'opération échouera.
Sortie	Si l'opération réussit, le nombre de bits définis sur 1 dans la clé est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable la commande `TR.SETBITS foo 0`. Exemple de commande : `TR.APPENDBITARRAY foo 1 1101` Exemple de sortie : `(integer) 4` Dans ce cas, la clé TairRoaring foo est « 101101 ».

TR.FLIPRANGE

Item	Description
Syntaxe	`TR.FLIPRANGE key start end`
Complexité temporelle	O(C)
Description de la commande	Inverse les valeurs des bits dans la plage spécifiée d'une clé TairRoaring, en passant de 0 à 1 ou de 1 à 0. La plage constitue un intervalle fermé. Si la clé n'existe pas, elle est créée en tant qu'ensemble de données vide et l'opération est effectuée sur cette clé.
Paramètre	Key : nom de la clé (structure de données TairRoaring). start : décalage de début (inclus), avec des valeurs comprises entre 0 et 2^32. end : décalage de fin (inclus), avec des valeurs comprises entre 0 et 2^32.
Sortie	Si l'opération réussit, le nombre de bits définis sur 1 dans la clé est renvoyé. Si la clé n'existe pas, elle est créée en tant qu'ensemble de données vide et l'opération est effectuée sur cette clé. En cas de succès, le nombre de bits définis sur 1 dans la clé est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable la commande `TR.SETBITS foo 0 2 3 5`. Exemple de commande : `TR.FLIPRANGE foo 0 5` Exemple de sortie : `(integer) 2` Dans ce cas, la clé TairRoaring foo est « 01001 ».

TR.APPENDINTARRAY

Item	Description
Syntaxe	`TR.APPENDINTARRAY key value [value1 value2 ... valueN]`
Complexité temporelle	O(C)
Description de la commande	Définit la valeur du bit spécifié dans une clé TairRoaring sur 1. Vous pouvez spécifier plusieurs valeurs de bits. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.SETBITS plutôt que cette commande.
Paramètre	Key : nom de la clé (structure de données TairRoaring). value : décalage entier du bit que vous souhaitez traiter. Valeurs valides : de 0 à 4294967296.
Sortie	Si l'opération réussit, OK est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.APPENDINTARRAY foo 9 10` Exemple de sortie : `OK`

TR.SETINTARRAY

Item	Description
Syntaxe	`TR.SETINTARRAY key value [value1 value2 ... valueN]`
Complexité temporelle	O(C)
Description de la commande	Crée une clé TairRoaring basée sur le tableau d'entiers spécifié. Si la clé existe déjà, cette commande écrase les données qu'elle contient. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.SETBITS plutôt que cette commande.
Paramètre	Key : nom de la clé (structure de données TairRoaring). value : entier spécifiant la position du bit à définir.
Sortie	Si l'opération réussit, OK est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.SETINTARRAY foo 2 4 5 6` Exemple de sortie : `OK`

TR.SETBITARRAY

Item	Description
Syntaxe	`TR.SETBITARRAY key value`
Complexité temporelle	O(C)
Description de la commande	Crée une clé TairRoaring basée sur la chaîne de tableau de bits spécifiée. La chaîne de tableau de bits est composée de 0 et de 1. Si la clé existe déjà, cette commande écrase les données qu'elle contient. Remarque Dans TairRoaring V2, nous vous recommandons d'utiliser TR.APPENDBITARRAY plutôt que cette commande.
Paramètre	key : clé que vous souhaitez gérer en exécutant cette commande. value : chaîne de 0 et de 1 représentant le tableau de bits.
Sortie	Si l'opération réussit : `OK` est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `tr.setbitarray foo 10101001` Exemple de sortie : `OK`

TR.BITOP

Item	Description
Syntaxe	`TR.BITOP destkey operation key [key1 key2 ... keyN]`
Complexité temporelle	O(C * M)
Description de la commande	Exécute des opérations ensemblistes sur des Roaring Bitmaps et stocke le résultat dans la clé de destination (destkey). Cette commande prend en charge les opérations AND, OR, XOR, NOT et DIFF. Remarque Cette commande n'est pas disponible pour les clés réparties sur plusieurs slots dans les instances de cluster.
Options	destkey : la clé de destination qui stocke le résultat (structure de données TairRoaring). operation : le type d'opération ensembliste. Valeurs valides : AND (ET logique), OR (OU logique), XOR (OU exclusif), NOT (NON logique) et DIFF (différence). Remarque Les opérations NOT ne peuvent être effectuées que sur une seule clé. Les opérations DIFF ne peuvent être effectuées que sur deux clés. Respectez l'ordre des clés. Par exemple, la commande `TR.BITOP result DIFF key1 key2` soustrait key2 de key1 (key1 - key2). key : la clé de la structure de données TairRoaring. Vous pouvez spécifier plusieurs clés.
Résultat	En cas de succès, la commande renvoie le nombre entier de bits définis à 1 dans le résultat. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.BITOP result OR foo bar` Exemple de résultat : `(integer) 6`

TR.BITOPCARD

Item	Description
Syntaxe	`TR.BITOPCARD operation key [key1 key2 ... keyN]`
Complexité temporelle	O(C * M)
Description de la commande	Effectue une opération bit à bit sur plusieurs clés TairRoaring. Les opérations bit à bit AND, OR, XOR, NOT et DIFF sont prises en charge. Remarque Cette commande n'est pas disponible pour les clés réparties sur plusieurs slots dans les instances de cluster.
Options	operation : le type d'opération ensembliste. Valeurs valides : AND, OR, XOR, NOT et DIFF. Remarque Les opérations NOT ne peuvent être effectuées que sur une seule clé. Les opérations DIFF permettent de calculer la différence entre deux clés uniquement. Tenez compte de l'ordre des opérations lors du calcul de la différence. Par exemple, la commande `TR.BITOP result DIFF key1 key2` calcule la différence de key1 par rapport à key2 (key1 - key2). key : le nom de la clé (structure de données TairRoaring). Vous pouvez spécifier plusieurs clés.
Résultat	En cas de succès, la commande renvoie le nombre entier de bits définis à 1 dans le résultat. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.BITOPCARD NOT foo` Exemple de résultat : `(integer) 2`

TR.OPTIMIZE

Item	Description
Syntaxe	`TR.OPTIMIZE key`
Complexité temporelle	O(M)
Description de la commande	Optimise le stockage d'une clé TairRoaring. Utilisez cette commande si la clé est relativement volumineuse et principalement utilisée pour des opérations de lecture après sa création.
Options	Key : le nom de la clé (structure de données TairRoaring).
Résultat	En cas de succès, la commande renvoie OK. Si la clé n'existe pas, la commande renvoie `nil`. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.OPTIMIZE foo` Exemple de résultat : `OK`

TR.GETBIT

Item	Description
Syntaxe	`TR.GETBIT key offset`
Complexité temporelle	O(1)
Description de la commande	Récupère la valeur du bit spécifié à partir d'une clé TairRoaring.
Options	Key : le nom de la clé (structure de données TairRoaring). offset : le décalage que vous souhaitez interroger.
Résultat	En cas de succès, la commande renvoie une valeur de 0 ou 1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.GETBIT foo 0` Exemple de résultat : `(integer) 1`

TR.GETBITS

Item	Description
Syntaxe	`TR.GETBITS key offset [offset1 offset2 ... offsetN]`
Complexité temporelle	O(C)
Description de la commande	Récupère la valeur des bits spécifiés à partir d'une clé TairRoaring. Vous pouvez spécifier plusieurs bits pour la récupération des valeurs.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). offset : le décalage que vous souhaitez interroger.
Résultat	En cas de succès, la valeur du bit est renvoyée. Si la clé n'existe pas, un tableau vide est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.GETBITS foo 3 4 6 8` Exemple de résultat : `1) (integer) 1 2) (integer) 1 3) (integer) 1 4) (integer) 0`

TR.BITCOUNT

Item	Description
Syntaxe	`TR.BITCOUNT key [start end]`
Complexité temporelle	O(M)
Description de la commande	Compte le nombre de bits définis à 1 dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). start : le décalage de début (inclus), avec des valeurs comprises entre 0 et 2^32. end : le décalage de fin (inclus), avec des valeurs comprises entre 0 et 2^32.
Résultat	En cas de succès, la commande renvoie le nombre entier de bits définis à 1 dans la clé. Si la clé n'existe pas, la commande renvoie une valeur de 0. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.BITCOUNT foo 4 9` Exemple de résultat : `(integer) 3`

TR.BITPOS

Item	Description
Syntaxe	`TR.BITPOS <key> <value> [count]`
Complexité temporelle	O(C)
Description de la commande	Récupère le décalage du bit dont le numéro ordinal correspond à count. Un bit peut avoir une valeur de 1 ou 0. Le paramètre count est facultatif et sa valeur par défaut est 1. Une valeur de 1 indique le premier bit récupéré selon l'approche de comptage de gauche à droite.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). value : la valeur du bit dont vous souhaitez récupérer le décalage. La valeur du bit peut être 0 ou 1. count : le numéro ordinal du bit. Un nombre négatif indique que l'approche de comptage de droite à gauche est utilisée.
Résultat	En cas de succès, le décalage du bit ayant une valeur de 1 ou 0 est renvoyé. Si la clé n'existe pas, la commande renvoie une valeur de -1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.BITPOS foo 1 -1` Exemple de résultat : `(integer) 6`

TR.SCAN

Item	Description
Syntaxe	`TR.SCAN key start_offset [COUNT count]`
Complexité temporelle	O(C)
Description de la commande	Analyse tous les bits situés après un bit spécifié dans une clé TairRoaring et renvoie les décalages correspondant à un nombre donné de bits analysés ayant une valeur de 1. Le curseur renvoyé correspond au décalage associé à la clé. Remarque Cette commande peut analyser et renvoyer, ou non, les éléments ajoutés ou supprimés.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). start_offset : le décalage du bit. Le bit correspondant à ce décalage est analysé. COUNT : le nombre de bits que vous souhaitez interroger. Valeur par défaut : 10.
Résultat	En cas de succès, un tableau contenant deux éléments est renvoyé : Le premier élément est la prochaine valeur start_offset. Si la clé a été entièrement analysée, une valeur de 0 est renvoyée. Le deuxième élément : le décalage cible de la requête actuelle. Remarque Si la clé n'existe pas, un tableau composé de 0 et d'éléments vides est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.SCAN foo 0 COUNT 2` Exemple de résultat : `1) (integer) 3 2) 1) (integer) 0 2) (integer) 2`

TR.RANGE

Catégorie	Description
Syntaxe	`TR.RANGE key start end`
Complexité temporelle	O(C)
Description de la commande	Renvoie les décalages des bits ayant une valeur de 1 dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). start : la valeur de début de l'intervalle (inclusive). end : la valeur de fin de l'intervalle (inclusive).
Résultat	En cas de succès, les décalages des bits ayant une valeur de 1 sont renvoyés. Si la clé n'existe pas, un tableau vide est renvoyé. Sinon, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable la commande `TR.SETBITS foo 0 2 3 5`. Exemple de commande : `TR.RANGE foo 0 5` Exemple de résultat : `1) (integer) 0 2) (integer) 2 3) (integer) 3 4) (integer) 5`

TR.RANGEBITARRAY

Item	Description
Syntaxe	`TR.RANGEBITARRAY key start end`
Complexité temporelle	O(C)
Description de la commande	Récupère une chaîne composée de valeurs de bits 0 et 1 dans la plage spécifiée d'une clé TairRoaring. La plage est un intervalle fermé.
Paramètre	Key : le nom de la clé (structure de données TairRoaring). start : la valeur de début de l'intervalle (inclusive). end : la valeur de fin de l'intervalle (inclusive).
Résultat	En cas de succès, les décalages des bits ayant une valeur de 1 sont renvoyés. Si la clé n'existe pas, la commande renvoie `nil`. Sinon, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable la commande `TR.SETBITS foo 0 2 3 5`. Exemple de commande : `TR.RANGEBITARRAY foo 0 5` Exemple de résultat : `"101101"`

TR.MIN

Item	Description
Syntaxe	`TR.MIN key`
Complexité temporelle	O(1)
Description de la commande	Récupère le décalage du premier bit ayant une valeur de 1 dans une clé TairRoaring. Si aucun bit n'a la valeur 1, la commande renvoie -1.
Paramètre	Key : le nom de la clé (structure de données TairRoaring).
Résultat	En cas de succès : Si des bits ayant une valeur de 1 existent dans la clé, le décalage entier du premier bit ayant une valeur de 1 est renvoyé. Si aucun bit ayant une valeur de 1 n'existe dans la clé ou si la clé n'existe pas, la commande renvoie -1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.MIN foo` Exemple de résultat : `4`

TR.MAX

Item	Description
Syntaxe	`TR.MAX key`
Complexité temporelle	O(1)
Description de la commande	Récupère le décalage du dernier bit ayant une valeur de 1 dans un Roaring Bitmap. Si aucun bit n'a la valeur 1, la commande renvoie -1.
Options	Key : le nom de la clé (structure de données TairRoaring).
Résultat	En cas de succès : Si des bits ayant une valeur de 1 existent dans la clé, le décalage entier du dernier bit ayant une valeur de 1 est renvoyé. Si aucun bit ayant une valeur de 1 n'existe dans la clé ou si la clé n'existe pas, la commande renvoie -1. Sinon, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.MAX foo` Exemple de résultat : `6`

TR.STAT

Élément	Description
Syntaxe	`TR.STAT key [JSON]`
Complexité temporelle	O(M)
Description de la commande	Renvoie les informations statistiques relatives à la clé TairRoaring spécifiée. Ces informations incluent le nombre de conteneurs et l'utilisation de la mémoire.
Paramètre	Key : nom de la clé (structure de données TairRoaring). JSON : si ce paramètre est spécifié, les informations statistiques sont renvoyées au format JSON.
Résultat	En cas de réussite, le résultat suivant est renvoyé : "{\"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}}" Si la clé n'existe pas, la valeur `nil` est renvoyée. Dans le cas contraire, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.STAT foo JSON` Exemple de résultat : `"{\"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}}"`

TR.JACCARD

Élément	Description
Syntaxe	`TR.JACCARD key1 key2`
Complexité temporelle	O(M)
Description de la commande	Récupère le coefficient de similarité de Jaccard de deux clés TairRoaring. Plus le coefficient est élevé, plus la similarité est grande. Remarque Cette commande n'est pas disponible pour les clés situées dans différents slots sur les instances en cluster.
Paramètre	Key : nom de la clé (structure de données TairRoaring).
Résultat	En cas de réussite, un coefficient de similarité de Jaccard de type double est renvoyé. Dans le cas contraire, un message d'erreur est renvoyé.
Exemple	Exemple de commande : `TR.JACCARD foo1 foo2` Exemple de résultat : `"0.20000000000000001"`

TR.CONTAINS

Catégorie	Description
Syntaxe	`TR.CONTAINS key1 key2`
Complexité temporelle	O(M)
Description de la commande	Vérifie si key2 contient key1. Si c'est le cas, key1 est un sous-ensemble de key2 et la valeur 1 est renvoyée. Sinon, key1 n'est pas un sous-ensemble de key2 et la valeur 0 est renvoyée. Remarque Cette commande n'est pas disponible pour les clés situées dans différents slots sur les instances en cluster.
Options	Key : nom de la clé (structure de données TairRoaring).
Résultat	En cas de réussite : Si key2 contient key1, la valeur 1 est renvoyée. Si key2 ne contient pas key1, la valeur 0 est renvoyée. Dans le cas contraire, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable les commandes `TR.SETBITS fooM 1 2 3 10` et `TR.SETBITS foom 1 2`. Exemple de commande : `TR.CONTAINS foom fooM` Exemple de résultat : `(integer) 1`

TR.RANK

Élément	Description
Syntaxe	`TR.RANK key offset`
Complexité temporelle	O(M)
Description de la commande	Récupère le nombre de bits ayant la valeur 1 dans la plage allant du premier bit au bit spécifié. La plage constitue un intervalle fermé.
Options	Key : nom de la clé (structure de données TairRoaring). offset : décalage du bit spécifié. La valeur doit être un entier.
Résultat	En cas de réussite, le nombre de bits ayant la valeur 1 est renvoyé. Dans le cas contraire, un message d'erreur est renvoyé.
Exemple	Exécutez au préalable la commande `TR.SETBITS fooM 1 2 3 10`. Exemple de commande : `TR.RANK fooM 10` Exemple de résultat : `(integer) 4`

Messages d'erreur

Message d'erreur	Description
`WRONGTYPE Operation against a key holding the wrong kind of value`	Type d'objet incorrect : la clé n'est pas un objet TairRoaring.
`ERR bad arguments, must be unsigned 32-bit integer`	Type de paramètre incorrect : les valeurs des paramètres ne peuvent pas être converties en entiers 32 bits.
`ERR invalid arguments, maybe out of range or illegal`	Paramètres invalides : Le décalage n'est pas un entier 32 bits. Les décalages de début et de fin ne sont pas valides. La valeur du paramètre dépasse le nombre maximal d'éléments autorisés pour une clé TairRoaring.
`ERR key already exist`	La clé TairRoaring existe déjà et ses données ne peuvent pas être écrasées. Remarque Cette erreur est corrigée dans TairRoaring V2.2.
`ERR key not found`	L'objet Roaring Bitmap n'existe pas. Cette opération n'est pas prise en charge. Remarque Cette erreur est corrigée dans TairRoaring V2.2.