TS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

EXTS.P.CREATE foo

返回示例：

OK

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。
• Skey：Skey名称。
• DATA_ET time：DataPoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。
• CHUNK_SIZE：单个Chunk可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。
• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

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

返回示例：

OK

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

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。
• Skey：Skey名称。
• DATA_ET time：DataPoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

EXTS.S.ALTER foo temperature DATA_ET 100000

返回示例：

OK

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

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。
• Skey：Skey名称。
• ts：Datapoint数据的Unix时间戳，单位为毫秒，支持用*表示系统当前的时间戳。
• value：Datapoint数据的值，数据类型为双精度浮点（double）型。
• DATA_ET time：DataPoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。
• CHUNK_SIZE：单个Chunk可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。
• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

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

返回示例：

OK

在指定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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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

向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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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"

在指定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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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

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

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

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

EXTS.S.DEL foo temperature

返回示例：

OK

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

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

• 执行成功：返回对应的Datapoint数据。
• nil：表示Pkey或Skey不存在。
• 其它情况返回相应的异常信息。

命令示例：

EXTS.S.GET foo temperature

返回示例：

1) (integer) 1644372730150
2) "32.2"

查询指定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"

在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"

在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表示已全部显示。

在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

在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会将该时间范围内的数据进行聚合并返回一个结果，返回的时间点为采样间隔的开始时间。

• WITHLABELS：设置返回结果中是否包含标签信息，默认为不填（不显示标签信息）。
• 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

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

• Pkey：PKey名称（TairTS数据结构），用于指定命令调用的TairTS对象。
• Skey：Skey名称。
• ts：待更新Datapoint的Unix时间戳，单位为毫秒。
• value：待更新的值，数据类型为双精度浮点（double）型。
• DATA_ET time：DataPoint数据的相对过期时间，单位为毫秒，默认为不填（表示不会过期）。
• CHUNK_SIZE：单个Chunk可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• UNCOMPRESSED：设置Skey不开启压缩，默认为不填（即开启压缩）。
• LABELS：Skey的属性，输入一组或多组对应的标签名、标签值，例如LABELS sensor_id 1。

• OK：表示执行成功。
• 其它情况返回相应的异常信息。

命令示例：

EXTS.S.RAW_MODIFY foo temperature 1644310456023 31.5

返回示例：

OK

批量修改多个指定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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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

该命令中的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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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"

批量修改多个指定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可保存的Datapoint数，默认值为256条，取值范围为[1,256]。
• 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