TS

类别

说明

语法

EXTS.P.CREATE Pkey

时间复杂度

O(1)

命令描述

创建一个新的Pkey（TairTS数据结构），若Pkey已存在则创建失败。

选项

• Pkey：Key名称（TairTS数据结构），用于指定命令调用的TairTS对象。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.P.CREATE foo

返回示例：

OK

类别

说明

语法

EXTS.S.CREATE Pkey Skey [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 label2 val2 ...]

时间复杂度

O(1)

命令描述

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，用于存储Datapoint。单位为16 byte（字节），默认值为256，意味着系统会直接给该Chunk分配4 KB内存（16 byte * 256）用于存储Datapoint数据，当该Chunk写满时系统会再创建一个新的Chunk，以此类推。CHUNK_SIZE取值范围为[1,256]。

  说明

  以CHUNK_SIZE为256为例，若Skey不开启压缩，单个Chunk能存储256个Datapoint数据；若开启压缩，则能存储超过256个，但具体能存多少取决于不同数据的压缩效果。

  为节省内存空间以及平衡读写效率，关于设置CHUNK_SIZE的建议如下：

  • 若Skey的平均数据点大于5,000个，设置CHUNK_SIZE为256（默认值）。大Chunk可以减少整体的Chunk数量，减少元数据的占用。

  • 若Skey的平均数据点小于5,000个，设置CHUNK_SIZE为平均数据点个数 / 20。例如某Skey的平均数据点为1,000，可以设置CHUNK_SIZE为50。在小范围查询时仅需解压缩更少数据，可以获得更好的性能。但如果在此情况下写入大量数据，会因创建大量Chunk而导致性能变慢。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.CREATE foo temperature DATA_ET 10000000 LABELS sensor_id 1

返回示例：

OK

类别

说明

语法

EXTS.S.ALTER Pkey Skey [DATA_ET time]

时间复杂度

O(1)

命令描述

修改指定Skey的元数据信息，当前仅支持修改过期时间（DATA_ET）。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.ALTER foo temperature DATA_ET 100000

返回示例：

OK

类别

说明

语法

EXTS.S.ADD Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(1)

命令描述

向Skey中插入一条Datapoint数据。若Pkey或Skey不存在则会自动创建，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• ts：Datapoint数据的Unix时间戳，单位为毫秒，支持用*表示系统当前的时间戳。

• value：Datapoint数据的值，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.ADD foo temperature * 30.5 DATA_ET 1000000 LABELS sensor_id 1

返回示例：

OK

类别

说明

语法

EXTS.S.MADD Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(n)，其中n为keynumber。

命令描述

在指定Pkey的多个Skey中分别插入一条Datapoint数据。若Pkey或Skey不存在则会自动创建，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• keynumber：指定多条数据的个数。

• Skey：Skey名称。

• ts：Datapoint数据的Unix时间戳，单位为毫秒，支持用*表示系统当前的时间戳。

• value：Datapoint数据的值，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.MADD foo 3 temperature * 30.2 pressure * 2.05 distance * 0.5

返回示例：

1) OK
2) OK
3) OK

类别

说明

语法

EXTS.S.INCRBY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(1)

命令描述

向Skey中插入一条Datapoint数据，该命令中的value将与Skey中最近Datapoint的value值相加实现递增，也可以指定该命令中的value为负数实现递减。若Pkey或Skey不存在则会自动创建，默认初始值为0，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• ts：Datapoint数据的Unix时间戳，单位为毫秒，支持用*表示系统当前的时间戳。

• value：待增加操作的值，可以指定该值为负数实现相减，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

提前执行EXTS.S.ADD foo temperature 1644310456023 30.0命令。

命令示例：

EXTS.S.INCRBY foo temperature 1644372093031 2

返回示例：

OK

1) (integer) 1644372093031
2) "32"

类别

说明

语法

EXTS.S.MINCRBY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(n)，其中n为keynumber。

命令描述

在指定Pkey的多个Skey分别插入一条Datapoint数据，该命令中的value将分别与各个Skey中最近Datapoint的value值相加实现递增，也可以指定该命令中的value为负数实现相减。若Pkey或Skey不存在则会自动创建，默认初始值为0，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• keynumber：指定多条数据的个数。

• Skey：Skey名称。

• ts：Datapoint数据的Unix时间戳，单位为毫秒，支持用*表示系统当前的时间戳。

• value：待增加操作的值，可以指定该值为负数实现相减，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.MINCRBY foo 3 temperature * 0.2 pressure * -0.1 distance * 0.0

返回示例：

1) OK
2) OK
3) OK

类别

说明

语法

EXTS.S.DEL Pkey Skey

时间复杂度

O(1)

命令描述

删除指定Pkey中的单个Skey，并删除目标Skey中所有的Datapoint数据。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.DEL foo temperature

返回示例：

OK

类别

说明

语法

EXTS.S.GET Pkey Skey

时间复杂度

O(1)

命令描述

查询指定Skey中最新的Datapoint数据。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

返回值

• 执行成功：返回对应的Datapoint数据。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.GET foo temperature

返回示例：

1) (integer) 1644372730150
2) "32.2"

类别

说明

语法

EXTS.S.INFO Pkey Skey

时间复杂度

O(1)

命令描述

查询指定Skey的元数据信息，包含Datapoint数量、最近Datapoint的时间戳与value值、Skey的标签信息等信息。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

返回值

• 执行成功：返回Skey的元数据信息。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.INFO foo temperature

返回示例：

 1) totalDataPoints            // Datapoint数量。
 2) (integer) 1
 3) maxDataPoints              // Skey可存储Datapoint数量的上限，默认为0（表示不限制）。
 4) (integer) 0
 5) maxDataPointsPerChunk      // 每个Chunk存储的Datapoint个数。
 6) (integer) 32
 7) dataPointsExpireTime       // Skey的相对过期时间（DATA_ET），单位为毫秒，0表示不过期。
 8) (integer) 0
 9) lastTimestamp              // 最近Datapoint的时间戳。
10) (integer) 1644389400996
11) chunkCount                 // Skey的chunk数量。
12) (integer) 1
13) lastValue                  // 最近Datapoint的value。
14) (integer) 28
15) labels                     // Skey的标签信息。
16) 1) 1) "sensor_id"
       2) "1"

类别

说明

语法

EXTS.S.QUERYINDEX Pkey filter1 [filter2 ...]

时间复杂度

O(n)，其中n为过滤条件中的最大集合数。

命令描述

在Pkey中自定义过滤条件（filter），查询目标Skey。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• filter：过滤条件，您可以根据Skey的标签（LABELS）过滤目标Skey，更多信息请参见索引过滤语法。

  说明

  构建filter时，必须存在EQ、CONTAINS、LIST_MATCH逻辑中的任意一个，否则会查询失败。

返回值

• 执行成功：返回符合过滤条件的Skey。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.QUERYINDEX foo sensor_id=1

返回示例：

1) "temperature"

类别

说明

语法

EXTS.S.RANGE Pkey Skey fromTs toTs [MAXCOUNT count] [AGGREGATION aggregationType timeBucket]

时间复杂度

O(n)，其中n为目标Datapoint的数据块个数。

命令描述

在Skey中查询指定时间内（包含指定时间点）的Datapoint数据。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• fromTs：查询的开始时间（Unix时间戳），单位为毫秒。

• toTs：查询的结束时间（Unix时间戳），单位为毫秒，支持用*表示系统当前的时间戳，若该值等于fromTs可实现单时间点查询。

• MAXCOUNT：指定返回的Datapoint条数，默认为不填（Tair的上限为1,000,000条）。

• AGGREGATION：

  • aggregationType：聚合类型，例如MAX（最大值）、AVG（平均值）、SUM（求和）等，更多信息请参见聚合功能语法。

  • timeBucket：采样间隔，单位为毫秒，最小值为1,000毫秒。

    Tair会将该时间范围内的数据进行聚合并返回一个结果，返回的时间点为采样间隔的开始时间。

  例如AGGREGATION AVG 5000将返回每5,000ms的平均数。

返回值

• 执行成功：返回对应的Datapoint数据，若命令中指定了聚合，则返回聚合结果。

  说明

  返回结果中会额外返回一个token值，0表示已全部显示，1表示还有符合条件的Datapoint数据未显示。您可以根据该值，同时将已返回结果中最后一个Datapoint的时间戳作为开始时间继续遍历获取，轻松实现分批聚合。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.RANGE foo test 1644459031662 * AGGREGATION AVG 10000 MAXCOUNT 2
// 求指定时间点内每10,000ms的平均数，同时指定返回2条数据。

返回示例：

1) 1) 1) (integer) 1644459730000
      2) "20.6"
   2) 1) (integer) 1644459790000
      2) "21.2"
2) (integer) 1                    // 1表示还有符合条件的Datapoint数据未显示，0表示已全部显示。

类别

说明

语法

EXTS.S.MRANGE Pkey fromTs toTs [MAXCOUNT count] [AGGREGATION aggregationType timeBucket] [WITHLABELS] FILTER filter1 [filter2 ...]

时间复杂度

O(n)，其中n为目标Datapoint的数据块个数。

命令描述

在Skey中自定义过滤条件（filter）与查询时间点（包含指定时间点），查询目标Datapoint数据。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• fromTs：查询的开始时间（Unix时间戳），单位为毫秒。

• toTs：查询的结束时间（Unix时间戳），单位为毫秒，支持用*表示系统当前的时间戳，若该值等于fromTs可实现单时间点查询。

• MAXCOUNT：指定每个Skey返回的Datapoint条数，默认为不填（Tair的上限为1,000,000条）。

• AGGREGATION：

  • aggregationType：聚合类型，例如MAX（最大值）、AVG（平均值）、SUM（求和）等，更多信息请参见聚合功能语法。

  • timeBucket：采样间隔，单位为毫秒，最小值为1,000毫秒。

    Tair会将该时间范围内的数据进行聚合并返回一个结果，返回的时间点为采样间隔的开始时间。

• WITHLABELS：设置返回结果中是否包含标签信息，默认为不填（不显示标签信息）。

• filter：过滤条件，您可以根据Skey的标签（LABELS）过滤目标Skey，更多信息请参见索引过滤语法。

  说明

  构建filter时，必须存在EQ、CONTAINS、LIST_MATCH逻辑中的任意一个，否则会查询失败。

返回值

• 执行成功：返回符合过滤条件的Skey组信息。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.MRANGE foo 1644451031662 * AGGREGATION MAX 10000 WITHLABELS FILTER sensor_id=1

返回示例：

1) 1) "temperature"
   2) 1) 1) "sensor_id"
         2) "1"
   3) 1) 1) (integer) 1644481000000
         2) "30"
   4) (integer) 0
2) 1) "test"
   2) 1) 1) "sensor_id"
         2) "1"
   3) 1) 1) (integer) 1644459730000
         2) "20"
      2) 1) (integer) 1644459790000
         2) "20"
      3) 1) (integer) 1644460620000
         2) "29"
   4) (integer) 0

类别

说明

语法

EXTS.P.RANGE Pkey fromTs toTs pkeyAggregationType pkeyTimeBucket [MAXCOUNT count] [AGGREGATION aggregationType timeBucket] FILTER filter1 [filter2 ...]

时间复杂度

O(n)，其中n为目标Datapoint的数据块个数。

命令描述

在Pkey层级对符合过滤条件（filter）的Datapoint数据进行聚合，若您指定了Skey层级的聚合，则会优先进行Skey层级聚合（效果与EXTS.S.MRANGE命令相同），再从Pkey层级对第一次聚合结果进行二次聚合。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• fromTs：查询的开始时间（Unix时间戳），单位为毫秒。

• toTs：查询的结束时间（Unix时间戳），单位为毫秒，支持用*表示系统当前的时间戳，若该值等于fromTs可实现单时间点查询。

• pkeyAggregationType：Pkey的聚合类型，更多信息请参见聚合功能语法。

• pkeyTimeBucket：Pkey的采样间隔，单位为毫秒，最小值为1,000毫秒。

  Tair会将该时间范围内的数据进行聚合并返回一个结果，返回的时间点为采样间隔的开始时间。

• MAXCOUNT：指定每个Skey返回的Datapoint条数，默认为不填（Tair的上限为1,000,000条）。

• AGGREGATION：

  • aggregationType：Skey的聚合类型，更多信息请参见聚合功能语法。

  • timeBucket：Skey的采样间隔，单位为毫秒，最小值为1,000毫秒。

    Tair会将该时间范围内的数据进行聚合并返回一个结果，返回的时间点为采样间隔的开始时间。

• filter：过滤条件，您可以根据Skey的标签（LABELS）过滤目标Skey，更多信息请参见索引过滤语法。

  说明

  构建filter时，必须存在EQ、CONTAINS、LIST_MATCH逻辑中的任意一个，否则会查询失败。

返回值

• 执行成功：返回聚合结果。

• nil：表示Pkey或Skey不存在。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.P.RANGE foo 1644451031662 * SUM 500000 AGGREGATION SUM 10000 FILTER sensor_id=1

返回示例：

1) 1) 1) (integer) 1644459500000
      2) "40"
   2) 1) (integer) 1644460500000
      2) "29"
   3) 1) (integer) 1644481000000
      2) "30"
2) (integer) 0

类别

说明

语法

EXTS.S.RAW_MODIFY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(1)

命令描述

修改指定Skey中Datapoint数据的value值。若Pkey或Skey不存在则会自动创建，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• ts：待更新Datapoint的Unix时间戳，单位为毫秒。

• value：待更新的值，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.RAW_MODIFY foo temperature 1644310456023 31.5

返回示例：

OK

类别

说明

语法

EXTS.S.RAW_MMODIFY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(n)，其中n为keynumber。

命令描述

批量修改多个指定Skey中Datapoint数据的value值。若Pkey或Skey不存在则会自动创建，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• keynumber：指定多条数据的个数。

• Skey：Skey名称。

• ts：待更新Datapoint的Unix时间戳，单位为毫秒。

• value：待更新的值，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.RAW_MMODIFY foo 3 temperature 1644565954814 30.2 pressure 1644565954814 2.05 distance 1644565954814 0.5

返回示例：

1) OK
2) OK
3) OK

类别

说明

语法

EXTS.S.RAW_INCRBY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(1)

命令描述

该命令中的value值会与指定Skey中Datapoint数据的value相加实现递增，也可以指定该命令中的value为负数实现递减。若Pkey或Skey不存在则会自动创建，默认初始值为0，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• Skey：Skey名称。

• ts：待更新Datapoint的Unix时间戳，单位为毫秒。

• value：待增加操作的值，可以指定该值为负数实现相减，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

提前执行EXTS.S.ADD foo temperature 1644310456 30.0命令。

命令示例：

EXTS.S.RAW_INCRBY foo temperature 1644310456 3.3

返回示例：

OK

1) (integer) 1644310456
2) "33.3"

类别

说明

语法

EXTS.S.RAW_MINCRBY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

时间复杂度

O(n)，其中n为keynumber。

命令描述

批量修改多个指定Skey中Datapoint数据的value值，该命令中的value值会与指定Skey中Datapoint数据的value相加实现递增，也可以指定该命令中的value为负数实现递减。若Pkey或Skey不存在则会自动创建，属性（过期时间、是否开启压缩等）仅在Skey不存在并自动创建的情况下生效。

选项

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。

• keynumber：指定多条数据的个数。

• Skey：Skey名称。

• ts：待更新Datapoint的Unix时间戳，单位为毫秒。

• value：待增加操作的值，可以指定该值为负数实现相减，数据类型为双精度浮点（double）型。

• DATA_ET time：Datapoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• CHUNK_SIZE：单个Chunk的大小，单位为16 byte（字节），默认值为256，取值范围为[1,256]。更多信息请参见EXTS.S.CREATE中的说明。

• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。

• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

返回值

• OK：表示执行成功。

• 其它情况返回相应的异常信息。

示例

命令示例：

EXTS.S.RAW_MINCRBY foo 3 temperature 1644565954814 30.2 pressure 1644565954814 2.05 distance 1644565954814 0.5

返回示例：

1) OK
2) OK
3) OK

filter命令

说明

逻辑

L = V

标签L等于V。

EQ（equals）

L !=

标签L不为NULL, 即目标Skey包含标签L。

CONTAINS

L = (v1,v2,...)

标签L为v1或v2等。

LIST_TMATCH

L != V

标签L不等于V。

NOEQ（equals）

L =

标签L为NULL, 即目标Skey不包含标签L。

NOCONTAINS

L != (v1,v2,...)

标签L不为v1和v2等。

LIST_NOTMATCH