The TairRoaring data structure is a Tair-based Roaring bitmap implementation. This topic introduces TairRoaring and its supported commands.

Overview

Bitmap (also known as bitset) is a common data structure that uses small amounts of storage to optimize queries of large amounts of data. Bitmaps save more space than hash-based implementations but are unsuitable for storing sparse data. Compressed bitmaps were developed in response to this issue. Roaring bitmaps are a more efficient and balanced type of compressed bitmaps recognized by the industry.

Roaring bitmaps are optimized in TairRoarings in the following ways:
  • TairRoarings can strike a balance between performance and space complexity by means of two-level indexes and dynamic containers.
  • TairRoarings use optimization techniques such as single instruction, multiple data (SIMD), vectorization, and popcount algorithms to improve computing efficiency and deliver efficient time and space complexity.
  • TairRoarings provide powerful computing performance and high stability for a variety of business scenarios based on ApsaraDB for Redis Enhanced Edition (Tair).
Typical scenarios

TairRoarings are suitable for use in industries such as live streaming, music, and e-commerce. You can use TairRoarings to add multidimensional tags to users for scenarios such as personalized recommendation and precision marketing.

Release notes
Notice Changes in TairRoaring V2:
  • TR.RANGEINTARRAY: TR.RANGEINTARRAY in TairRoaring V1 is changed to TR.RANGE in TairRoaring V2.
  • TR.SETRANGE: The output of TR.SETRANGE is changed from OK in TairRoaring V1 to the number of bits set to 1 in TairRoaring V2.
  1. On Sep 13, 2021, TairRoaring V1 was released.
  2. On March 11, 2022, TairRoaring V2 was released. We recommend that you update the minor version of your instance to 1.7.27 or later. For more information, see Update the minor version.

    TairRoaring V2 optimizes some command implementations and improves command performance. TairRoaring V2 comes with eight new commands including TR.SETBITS and TR.CLEARBITS, updates three commands with two of them still compatible with TairRoaring V1, and changes the name of one command. For more information, see Supported commands.

Best practices

Select users by using TairRoaring

Prerequisites

  • The instance is a performance-enhanced instance of the ApsaraDB for Redis Enhanced Edition (Tair). For more information, see Performance-enhanced instances.
  • The instance is updated to the latest minor version. For more information, see Update the minor version.
    Note If your instance is a cluster instance or read/write splitting instance, the proxy nodes in your instance must also be of the latest minor version to ensure that all commands can be run as expected. For more information about cluster instances and read/write splitting instances, see Cluster master-replica instances and Read/write splitting instances.

Precautions

The TairRoarings that you want to manage are stored in the performance-enhanced instance.

Note Some new commands and parameters are not supported on cluster instances, but developers will add support over time. If you want to use the new commands and parameters on your cluster instances, submit a ticket.

Supported commands

Type Command Syntax Description Version change
Write operation TR.SETBIT TR.SETBIT key offset value

Sets the specified bit in a TairRoaring key to a value of 1 or 0 and returns the original bit value. The offset starts from 0.

- (N/A)
TR.SETBITS TR.SETBITS key offset [offset1 offset2 ... offsetN]

Sets the value of the specified bit in a TairRoaring key to 1. You can specify multiple bit values.

Added in V2.
TR.CLEARBITS TR.CLEARBITS key offset [offset1 offset2 ... offsetN]

Sets the value of the specified bit in a TairRoaring key to 0. If the specified bit already has a value of 0, the operation is not performed. You can specify multiple bit values.

Added in V2.
TR.SETRANGE TR.SETRANGE key start end

Sets the bits within the specified range in a TairRoaring key to a value of 1. The range is a closed interval.

Updated in V2. After the command update in V2, the command output is changed to the number of bits set to 1.
TR.APPENDBITARRAY TR.APPENDBITARRAY key offset bitarray

Inserts a bit array into a position right behind the specified bit in a TairRoaring key and overwrites the original data. The bit array consists of 0 and 1.

Added in V2.
TR.FLIPRANGE TR.FLIPRANGE key start end

Switches the values for bits within the specified range in a TairRoaring key from 0 to 1 or from 1 to 0. The range is a closed interval.

Added in V2.
TR.APPENDINTARRAY TR.APPENDINTARRAY key value [value1 value2 ... valueN]
Sets the value of the specified bit in a TairRoaring key to 1. You can specify multiple bit values.
Note We recommend that you use TR.SETBITS in TairRoaring V2 instead of this command.
-
TR.SETINTARRAY TR.SETINTARRAY key value [value1 value2 ... valueN]
Creates a TairRoaring key from an integer array. If the key already exists, this command overwrites the data in the key.
Note We recommend that you use TR.SETBITS in TairRoaring V2 instead of this command.
-
TR.SETBITARRAY TR.SETBITARRAY key value
Creates a TairRoaring key based on the specified bit array string. The bit array string consists of 0 and 1. If the key already exists, this command overwrites the data in the key.
Note We recommend that you use TR.APPENDBITARRAY in TairRoaring V2 instead of this command.
-
TR.BITOP TR.BITOP destkey operation key [key1 key2 ... keyN]
Performs a bitwise operation on multiple TairRoaring keys and stores the result in the destination key. The AND, OR, XOR, NOT, and DIFF bitwise operations are supported.
Note This command is not supported by cluster instances.
-
TR.BITOPCARD TR.BITOPCARD operation key [key1 key2 ... keyN]
Performs a bitwise operation on multiple TairRoaring keys. The AND, OR, XOR, NOT, and DIFF bitwise operations are supported.
Note This command is not supported by cluster instances.
Added in V2.
TR.DIFF TR.DIFF destkey key1 key2

Calculates the difference between the key1 value and the key2 value and stores the result in the destination key.

Note
  • This command is not supported by cluster instances.
  • We recommend that you use TR.BITOP in TairRoaring V2 instead of this command.
-
TR.OPTIMIZE TR.OPTIMIZE key

Optimizes the storage of a TairRoaring key. If the key is relatively large and is used mainly for read operations after the key is created, you can run this command.

-
Read operation TR.GETBIT TR.GETBIT key offset

Retrieves the value of the specified bit from a TairRoaring key.

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

Retrieves the value of the specified bit from a TairRoaring key. You can specify multiple bit values.

Added in V2.
TR.BITCOUNT TR.BITCOUNT key [start end]

Counts the number of bits that have a value of 1 within the specified range in a TairRoaring key. The range is a closed interval.

Updated in V2 and compatible with V1.
TR.BITPOS TR.BITPOS <key> <value> [count]

Retrieves the offset of the bit that has an ordinal number of count. A bit can have a value of 1 or 0. The count parameter is optional and has a default value of 1, which indicates the first bit retrieved by using the left-right counting approach.

Updated in V2 and compatible with V1.
TR.SCAN TR.SCAN key start_offset [COUNT count]
Scans the bits located behind the specified bit in a TairRoaring key and returns the offsets corresponding to the scanned bits that have a value of 1. The returned cursor is the offset corresponding to the key.
Note This command may or may not scan and return added or deleted elements.
Added in V2.
TR.RANGE TR.RANGE key start end

Returns the offsets of the bits that have a value of 1 within the specified range in a TairRoaring key. The range is a closed interval.

Renamed as TR.RANGE in V2 from TR.RANGEINTARRAY in V1.
TR.MIN TR.MIN key

Retrieves the offset of the first bit that has a value of 1 in a TairRoaring key. If no bits have a value of 1, a value of -1 is returned.

-
TR.MAX TR.MAX key

Returns the offset of the last bit that has a value of 1 in a TairRoaring key. If no bits have a value of 1, -1 is returned.

-
TR.STAT TR.STAT key [JSON]

Returns the statistical information of the specified TairRoaring key. The information includes the number of containers and the memory usage.

Added in V2.
General-purpose operation DEL DEL key [key ...] Deletes one or more TairRoaring keys. -
Note
  • The following section describes the command syntax:
    • Uppercase keyword: the command keyword.
    • Italic: Words in italic indicate variable information that you supply.
    • [options]: optional parameters. Parameters that are not included in brackets are required.
    • A|B: specifies that these parameters are mutually exclusive. Select one of two or more parameters.
    • ...: specifies to repeat the preceding content.
  • In this topic, the letters used in time complexity expressions Time complexity indicate topic-specific meanings:
    • C indicates the argc or range of parameters.
    • M indicates the number of bits set to 1 in a data structure, such as the number of nodes in a list or the number of fields in a hash.

TR.SETBIT

Item Description
Syntax TR.SETBIT key offset value
Time complexity O(1)
Command description

Sets the specified bit in a TairRoaring key to a value of 1 or 0 and returns the original bit value. The offset starts from 0.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the integer offset of the bit that you want to process. Valid values: 0 to 2^32.
  • value: the value that you want to set for the bit. The value can be set to 1 or 0.
Output
  • If the operation is successful, a bit value of 0 or 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.SETBIT foo 0 1

Sample output:

(integer) 0

TR.SETBITS

Item Description
Syntax TR.SETBITS key offset [offset1 offset2 ... offsetN]
Time complexity O(C)
Command description

Sets the value of the specified bit in a TairRoaring key to 1. You can specify multiple bit values.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the integer offset of the bit that you want to process. Valid values: 0 to 2^32.
Output
  • If the operation is successful, the number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.SETBITS foo 9 10

Sample output:

(integer) 5

TR.CLEARBITS

Item Description
Syntax TR.CLEARBITS key offset [offset1 offset2 ... offsetN]
Time complexity O(C)
Command description

Sets the value of the specified bit in a TairRoaring key to 0. If the specified bit already has a value of 0, the operation is not performed. You can specify multiple bit values.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the integer offset of the bit that you want to process. Valid values: 0 to 2^32.
Output
  • If the operation is successful, the number of bits in the key that are set to 0 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.CLEARBITS foo 9 10

Sample output:

(integer) 2

TR.SETRANGE

Item Description
Syntax TR.SETRANGE key start end
Time complexity O(C)
Command description

Sets the bits within the specified range in a TairRoaring key to a value of 1. The range is a closed interval.

For example, if you run the TR.SETRANGE foo 1 3 command, the system creates the "0111" foo key.

Parameter
  • Key: the key that you want to manage by running this command.
  • start: the start value of the interval. Valid values: 0 to 2 ^ 32.
  • end: the end value of the interval. Valid values: 0 to 2 ^ 32.
Output
  • If the operation is successful, the number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.SETRANGE foo 1 3

Sample output:

(integer) 3

TR.APPENDBITARRAY

Item Description
Syntax TR.APPENDBITARRAY key offset bitarray
Time complexity O(C)
Command description

Inserts a bit array into a position right behind the specified bit in a TairRoaring key and overwrites the original data. The bit array consists of 0 and 1.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the offset of the specified bit. Valid values: -1 to 2 ^ 32.
  • bitarray: the bit array that you want to insert. The bit array consists of 0 and 1 and overwrites the original data. Valid values: 0 to 2 ^ 32.
    Note The offset and bit array that you specify cannot have a combined length longer than 2 ^ 32. Otherwise, the operation cannot be performed.
Output
  • If the operation is successful, the number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

The TR.SETBITS foo 0 command is run in advance.

Sample command:

TR.APPENDBITARRAY foo 1 1101

Sample output:

(integer) 3

In this case, the TairRoaring foo key is ”101101“.

TR.FLIPRANGE

Item Description
Syntax TR.FLIPRANGE key start end
Time complexity O(C)
Command description

Switches the values for bits within the specified range in a TairRoaring key from 0 to 1 or from 1 to 0. The range is a closed interval.

Parameter
  • Key: the key that you want to manage by running this command.
  • start: the start value of the interval. Valid values: 0 to 2 ^ 32.
  • end: the end value of the interval. Valid values: 0 to 2 ^ 32.
Output
  • If the operation is successful, the number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

The TR.SETBITS foo 0 2 3 5 command is run in advance.

Sample command:

TR.FLIPRANGE foo 0 5

Sample output:

(integer) 2

In this case, the TairRoaring foo key is "01001".

TR.APPENDINTARRAY

Item Description
Syntax TR.APPENDINTARRAY key value [value1 value2 ... valueN]
Time complexity O(C)
Command description
Sets the value of the specified bit in a TairRoaring key to 1. You can specify multiple bit values.
Note We recommend that you use TR.SETBITS in TairRoaring V2 instead of this command.
Parameter
  • Key: the key that you want to manage by running this command.
  • value: the integer bit value that you want to specify. Valid values: 0 to 4294967296.
Output
  • If the operation is successful, OK is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.APPENDINTARRAY foo 9 10

Sample output:

OK

TR.SETINTARRAY

Item Description
Syntax TR.SETINTARRAY key value [value1 value2 ... valueN]
Time complexity O(C)
Command description
Creates a TairRoaring key from an integer array. If the key already exists, this command overwrites the data in the key.
Note We recommend that you use TR.SETBITS in TairRoaring V2 instead of this command.
Parameter
  • Key: the key that you want to manage by running this command.
  • value: the integer bit value that you want to specify.
Output
  • If the operation is successful, OK is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.SETINTARRAY foo 2 4 5 6

Sample output:

OK

TR.SETBITARRAY

Item Description
Syntax TR.SETBITARRAY key value
Time complexity O(C)
Command description
Creates a TairRoaring key based on the specified bit array string. The bit array string consists of 0 and 1. If the key already exists, this command overwrites the data in the key.
Note We recommend that you use TR.APPENDBITARRAY in TairRoaring V2 instead of this command.
Parameter
  • key: the key that you want to manage by running this command.
  • value: the bit array string that consists of 0 and 1.
Output
  • If the operation is successful, OK is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

tr.setbitarray foo 10101001

Sample output:

OK 

TR.BITOP

Item Description
Syntax TR.BITOP destkey operation key [key1 key2 ... keyN]
Time complexity O(C * M)
Command description
Performs a bitwise operation on multiple TairRoaring keys and stores the result in the destination key. The AND, OR, XOR, NOT, and DIFF bitwise operations are supported.
Note This command is not supported by cluster instances.
Parameter
  • key: the key that you want to manage by running this command. Multiple keys can be specified.
  • operation: the type of the bitwise operation. Valid values: AND, OR, XOR, NOT, and DIFF.
    Note
    • The NOT operations can be performed only on one key.
    • The DIFF operations calculate the difference between only two keys. Take note of the order of operations for calculating the difference. For example, the TR.BITOP result DIFF key1 key2 command subtracts the key2 value from the key1 value.
  • destkey: the destination key that stores the result.
Output
  • If the operation is successful, the integer number of bits in the destination key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.BITOP result OR foo bar

Sample output:

(integer) 6

TR.BITOPCARD

Item Description
Syntax TR.BITOPCARD operation key [key1 key2 ... keyN]
Time complexity O(C * M)
Command description
Performs a bitwise operation on multiple TairRoaring keys. The AND, OR, XOR, NOT, and DIFF bitwise operations are supported.
Note This command is not supported by cluster instances.
Parameter
  • key: the key that you want to manage by running this command. Multiple keys can be specified.
  • operation: the type of the bitwise operation. Valid values: AND, OR, XOR, NOT, and DIFF.
    Note
    • The NOT operations can be performed only on one key.
    • The DIFF operations calculate the difference between only two keys. Take note of the order of operations for calculating the difference. For example, the TR.BITOP result DIFF key1 key2 command subtracts the key2 value from the key1 value.
Output
  • If the operation is successful, the integer number of bits in the result that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.BITOPCARD NOT foo

Sample output:

(integer) 2

TR.DIFF

Item Description
Syntax TR.DIFF destkey key1 key2
Time complexity O(C * M)
Command description

Calculates the difference between the key1 value and the key2 value and stores the result in the destination key.

Note
  • This command is not supported by cluster instances.
  • We recommend that you use TR.BITOP in TairRoaring V2 instead of this command.

When you use this command, take note of the order of operations for calculating the difference. In this example, the difference is calculated by subtracting the key2 value from the key1 value.

Parameter
  • Key: the key that you want to manage by running this command.
Output
  • Otherwise, an error message is returned.
Example

Sample command:

TR.DIFF result foo bar

Sample output:

OK

TR.OPTIMIZE

Item Description
Syntax TR.OPTIMIZE key
Time complexity O(M)
Command description

Optimizes the storage of a TairRoaring key. If the key is relatively large and is used mainly for read operations after the key is created, you can run this command.

Parameter
  • Key: the key that you want to manage by running this command.
Output
  • If the operation is successful, the number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.OPTIMIZE foo

Sample output:

OK

TR.GETBIT

Item Description
Syntax TR.GETBIT key offset
Time complexity O(1)
Command description

Retrieves the value of the specified bit from a TairRoaring key.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the offset of the bit whose value you want to retrieve.
Output
  • If the operation is successful, a value of 0 or 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.GETBIT foo 0

Sample output:

(integer) 1

TR.GETBITS

Item Description
Syntax TR.GETBITS key offset [offset1 offset2 ... offsetN]
Time complexity O(C)
Command description

Retrieves the value of the specified bit from a TairRoaring key. You can specify multiple bit values.

Parameter
  • Key: the key that you want to manage by running this command.
  • offset: the offset of the bit whose value you want to retrieve.
Output
  • If the operation is successful, the bit value is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.GETBITS foo 3 4 6 8

Sample output:

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

TR.BITCOUNT

Item Description
Syntax TR.BITCOUNT key [start end]
Time complexity O(M)
Command description

Counts the number of bits that have a value of 1 within the specified range in a TairRoaring key. The range is a closed interval.

Parameter
  • Key: the key that you want to manage by running this command.
  • start: the start value of the interval. Valid values: 0 to 2 ^ 32.
  • end: the end value of the interval. Valid values: 0 to 2 ^ 32.
Output
  • If the operation is successful, the integer number of bits in the key that are set to 1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.BITCOUNT foo 4 9

Sample output:

(integer) 3

TR.BITPOS

Item Description
Syntax TR.BITPOS <key> <value> [count]
Time complexity O(C)
Command description

Retrieves the offset of the bit that has an ordinal number of count. A bit can have a value of 1 or 0. The count parameter is optional and has a default value of 1, which indicates the first bit retrieved by using the left-right counting approach.

Parameter
  • Key: the key that you want to manage by running this command.
  • value: the value of the bit that you want to retrieve. The bit value can be 0 or 1.
  • count: the ordinal number of the bit. A negative number indicates that the right-left counting approach is used.
Output
  • If the operation is successful, the offset of the bit that has a value of 1 or 0 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.BITPOS foo 1 -1

Sample output:

(integer) 6

TR.SCAN

Item Description
Syntax TR.SCAN key start_offset [COUNT count]
Time complexity O(C)
Command description
Scans the bits located behind the specified bit in a TairRoaring key and returns the offsets corresponding to the scanned bits that have a value of 1. The returned cursor is the offset corresponding to the key.
Note This command may or may not scan and return added or deleted elements.
Parameter
  • Key: the key that you want to manage by running this command.
  • start_offset: the offset of the bit. The bit that matches this offset is scanned.
  • COUNT: the number of bits that you want to query. Default value: 10.
Output
  • If the operation is successful, an array containing two elements is returned:
    • The first element is the next start_offset value. If the key is scanned, a value of 0 is returned.
    • The second element is the next offset that you specify.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.SCAN foo 0 COUNT 2

Sample output:

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

TR.RANGE

Item Description
Syntax TR.RANGE key start end
Time complexity O(C)
Command description

Returns the offsets of the bits that have a value of 1 within the specified range in a TairRoaring key. The range is a closed interval.

Parameter
  • Key: the key that you want to manage by running this command.
  • start: the start value of the interval.
  • end: the end value of the interval.
Output
  • If the operation is successful, the offsets of the bits that have a value of 1 are returned.
  • Otherwise, an error message is returned.
Example

The TR.SETBITS foo 0 2 3 5 command is run in advance.

Sample command:

TR.RANGE foo 0 5

Sample output:

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

TR.MIN

Item Description
Syntax TR.MIN key
Time complexity O(1)
Command description

Retrieves the offset of the first bit that has a value of 1 in a TairRoaring key. If no bits have a value of 1, a value of -1 is returned.

Parameter
  • Key: the key that you want to manage by running this command.
Output
    • If the operation is successful, the integer offset of the first bit that has a value of 1 is returned.
    • If the operation is successful and no bits have a value of 1, a value of -1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.MIN foo

Sample output:

4

TR.MAX

Item Description
Syntax TR.MAX key
Time complexity O(1)
Command description

Returns the offset of the last bit that has a value of 1 in a TairRoaring key. If no bits have a value of 1, -1 is returned.

Parameter
  • Key: the key that you want to manage by running this command.
Output
    • If the operation is successful, the integer offset of the last bit that has a value of 1 is returned.
    • If the operation is successful and no bits have a value of 1, a value of -1 is returned.
  • Otherwise, an error message is returned.
Example

Sample command:

TR.MAX foo

Sample output:

6

TR.STAT

Item Description
Syntax TR.STAT key [JSON]
Time complexity O(M)
Command description

Returns the statistical information of the specified TairRoaring key. The information includes the number of containers and the memory usage.

Parameter
  • Key: the key that you want to manage by running this command.
  • JSON: If this parameter is specified, the statistical information is returned in the JSON format.
Output
  • If the operation is successful, the following output is returned:
    "{\"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}}"
    
                                            
  • Otherwise, an error message is returned.
Example

Sample command:

TR.STAT foo JSON

Sample output:

"{\"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}}"

Error messages

Error message Description
WRONGTYPE Operation against a key holding the wrong kind of value The key type is incorrect: The key is not a TairRoaring key.
ERR bad arguments, must be unsigned 32-bit integer The parameter type is incorrect: The parameter values cannot be converted into 32-bit integers.
ERR invalid arguments, maybe out of range or illegal The parameters are invalid:
  • The offset is not a 32-bit integer.
  • The start and end offsets are invalid.
  • The parameter value exceeds the maximum number of elements allowed for a TairRoaring key.
ERR key already exist The TairRoaring key already exists, and its data cannot be overwritten.
ERR key not found The TairRoaring key does not exist.