返回值

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

示例

创建一个 Pkey 名称为 test_exts 的 ExTimeSeries。

EXTS.PCREATE test_exts

返回示例。

OK

命令描述

在指定的 Pkey 中创建一个 Skey，若 Pkey 不存在则会自动创建一个新 Pkey，若 Skey 已经存在则创建失败。
您可以在创建时为 SKey 设置过期时间、是否开启压缩、标签等属性。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。
• CHUNK_SIZE：存储 Datapoint 数据的单个 chunk 大小。默认值：256。
  chunk 编码模式不同，CHUNK_SIZE 的含义不同。更多关于 CHUNK_SIZE 的说明，请参见数据结构说明-Chunk。
• ENCODING：设置是否为 Skey 开启压缩，该参数不填，表示默认开启压缩（即 COMPRESSED）。
• LABELS：Skey 的标签，支持同时设置多组标签，每组标签需同时设置对应的标签名和标签值，例如 LABELS stockid A issuer 1。

返回值

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

示例

• 命令示例一
  创建一个 Pkey 名称为 test_exts，Skey 名称为 closing_price 的 ExTimeSeries，并将该 Skey 的相对过期时间设置为 10,000,000 毫秒，包含 stockid A 和 issuer 1 2 个标签。

  EXTS.CREATE test_exts closing_price RETENTION 10000000 LABELS stockid A issuer 1
  

  返回示例。

  OK
  

• 命令示例二
  为已存在的 Pkey 名称为 test_exts 的 ExTimeSeries 创建一个名称为 volume 的 Skey ，并将该 Skey 的绝对过期时间设置为 20,000,000 毫秒， chunk size 为 150。

  EXTS.CREATE test_exts volume RETENTION 20000000 CHUNK_SIZE 150
  

  返回示例。

  OK
  

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。

返回值

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

示例

将 test_exts 中名为 volume 的 Skey 过期时间改为 15,000,000。

EXTS.ALTER test_exts volume RETENTION 15000000

返回示例。

OK

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待插入 Datapoint 的 Unix 时间戳，单位：毫秒，支持用 * 表示系统当前的时间戳。
• value：待插入 Datapoint 的数据值，数据类型为 Double。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。
• CHUNK_SIZE：存储 Datapoint 数据的单个 chunk 大小。默认值：256。
  chunk 编码模式不同，CHUNK_SIZE 的含义不同。更多关于 CHUNK_SIZE 的说明，请参见数据结构说明-Chunk。
• ENCODING：设置是否为 Skey 开启压缩，该参数不填，表示默认开启压缩（即 COMPRESSED）。
• LABELS：Skey 的标签，支持同时设置多组标签，每组标签需同时设置对应的标签名和标签值，例如 LABELS stockid A issuer 1。

返回值

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

示例

为已存在的 Pkey 名称为 test_exts 的 ExTimeSeries 创建一个名称为 issuer 的 Skey ，并为该 Skey 插入一条值为 66.0，时间戳为系统当前时间戳的 Datapoint 数据。创建 Skey 的同时为其设置相对过期时间为 10,000,000 毫秒，包含 stockid A 标签。

EXTS.ADD test_exts issuer * 66.0 RETENTION 10000000 LABELS stockid A

返回示例。

OK

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒。
• value：待更新 Datapoint 的数据值，数据类型为 Double。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。
• CHUNK_SIZE：存储 Datapoint 数据的单个 chunk 大小。默认值：256。
  chunk 编码模式不同，CHUNK_SIZE 的含义不同。更多关于 CHUNK_SIZE 的说明，请参见数据结构说明-Chunk。
• ENCODING：设置是否为 Skey 开启压缩，该参数不填，表示默认开启压缩（即 COMPRESSED）。
• LABELS：Skey 的标签，支持同时设置多组标签，每组标签需同时设置对应的标签名和标签值，例如 LABELS stockid A issuer 1。

返回值

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

示例

将 test_exts 中 Skey closing_price 在指定时间点的 Datapoint 数据值改为 89.0。

EXTS.MODIFY test_exts closing_price 1744255211538 89.0

返回示例。

OK

命令描述

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

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒，支持用 * 表示系统当前的时间戳。
• value：待递增的值，数据类型为 Double。若您将 value 值指定为负数则实现递减。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。
• CHUNK_SIZE：存储 Datapoint 数据的单个 chunk 大小。默认值：256。
  chunk 编码模式不同，CHUNK_SIZE 的含义不同。更多关于 CHUNK_SIZE 的说明，请参见数据结构说明-Chunk。
• ENCODING：设置是否为 Skey 开启压缩，该参数不填，表示默认开启压缩（即 COMPRESSED）。
• LABELS：Skey 的标签，支持同时设置多组标签，每组标签需同时设置对应的标签名和标签值，例如 LABELS stockid A issuer 1。

返回值

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

示例

例如，Pkey test_exts 中 Skey closing_price 的最近一条 Datapoint 值为 8.0，您可以通过如下命令为该 Skey 的 value 实现递增。

EXTS.INCRBY test_exts closing_price * 3

返回示例。

OK

若此时执行 EXTS.GET test_exts closing_price 命令，将会返回如下结果。

1) (integer) 1744254273078
2) "11"

命令描述

将该命令中的 value 与目标 Skey 中指定时间点的 Datapoint 所设 value 值相加实现递增。若您将命令中的 value 值指定为负数则实现递减。
若 Pkey 或 Skey 不存在则会自动创建，新建 Skey 中 Datapoint 的 value 初始值默认为 0。
Skey 的过期时间、是否开启压缩、标签等属性仅在需要自动创建 Skey 的情况下生效。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒。
• value：待递增的值，数据类型为 Double。若您将 value 值指定为负数则实现递减。
• RETENTION：Datapoint 数据的相对过期时间，单位：毫秒，取值不可超过 1 万亿毫秒。该参数不填表示不设置过期时间，即数据不会过期。

  说明

  • 当 Skey 中所有 Datapoint 数据都过期后，该 Skey 会被自动删除。
  • 当 Pkey 中不存在任何 Skey 时，该 Pkey 会被自动删除。
• CHUNK_SIZE：存储 Datapoint 数据的单个 chunk 大小。默认值：256。
  chunk 编码模式不同，CHUNK_SIZE 的含义不同。更多关于 CHUNK_SIZE 的说明，请参见数据结构说明-Chunk。
• ENCODING：设置是否为 Skey 开启压缩，该参数不填，表示默认开启压缩（即 COMPRESSED）。
• LABELS：Skey 的标签，支持同时设置多组标签，每组标签需同时设置对应的标签名和标签值，例如 LABELS stockid A issuer 1。

返回值

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

示例

例如，Pkey test_exts 中 Skey closing_price 在指定时间点的 Datapoint 值为 70.0，您可以通过如下命令为该 Skey 的 value 实现递减。

EXTS.INCRBY_TS test_exts closing_price 1744254890238 -30.0

返回示例。

OK

若此时执行 EXTS.GET test_exts closing_price 命令，将会返回如下结果。

1) (integer) 1744254890238
2) "40"

命令描述

为指定 Pkey 中的多个 Skey 分别插入一条 Datapoint 数据。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待插入 Datapoint 的 Unix 时间戳，单位：毫秒，支持用 * 表示系统当前的时间戳。
• value：待插入 Datapoint 的数据值，数据类型为 Double。

返回值

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

示例

为 Pkey test_exts 中的 volume 和 closing_price Skey 分别插入一条 Datapoint 数据。

EXTS.MADD test_exts volume * 66.0 closing_price * 8.0

返回示例。

1) OK
2) OK

命令描述

批量修改多个 Skey 中在指定时间点的 Datapoint 数据值。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒。
• value：待更新 Datapoint 的数据值，数据类型为 Double。

返回值

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

示例

将 test_exts 中 closing_price、volume 这两个 Skey 的 Datapoint 数据值分别改为 56.0 和 70.0。

EXTS.MMODIFY test_exts closing_price 1744255211538 56.0 volume 1744254890238 70.0

返回示例。

1) OK
2) OK

命令描述

为指定 Pkey 中的多个 Skey 分别插入一条 Datapoint 数据，并将该命令中的 value 与各个 Skey 中时间最近的 Datapoint 所设 value 值相加实现递增。若您将命令中的 value 值指定为负数则实现递减。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒，支持用 * 表示系统当前的时间戳。
• value：待递增的值，数据类型为 Double。若您将 value 值指定为负数则实现递减。

返回值

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

示例

命令示例。

EXTS.MINCRBY test_exts closing_price * -3.0 volume * 4.0

返回示例。

1) OK
2) OK

命令描述

批量修改多个目标 Skey 中 Datapoint 的 value。该命令中的 value 会与目标 Skey 中指定时间点的 Datapoint 所设 value 值相加实现递增。若您将命令中的 value 值指定为负数则实现递减。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• timestamp：待更新 Datapoint 的 Unix 时间戳，单位：毫秒。
• value：待递增的值，数据类型为 Double。若您将 value 值指定为负数则实现递减。

返回值

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

示例

命令示例。

EXTS.MINCRBY_TS test_exts closing_price 1744257305364 -25.0 volume 1744254890238 62.0

返回示例。

1) OK
2) OK

命令描述

删除指定 Pkey 中的目标 Skey，包括该 Skey 中所有的 Datapoint 数据。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。

返回值

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

示例

命令示例。

EXTS.DEL test_exts closing_price

返回示例。

OK

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。

返回值

• 执行成功：返回对应的 Datapoint 数据。
• 其它情况返回相应的异常信息。

示例

命令示例。

EXTS.GET test_exts closing_price

返回示例。

1) (integer) 1744254402895
2) "8"

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。

返回值

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

示例

命令示例。

EXTS.INFO test_exts closing_price

返回示例。

1) totalDataPoints
2) (integer) 4
3) maxDataPoints
4) (integer) 0
5) maxDataPointsPerChunk
6) (integer) 256
7) dataPointsExpireTime
8) (integer) 0
9) lastTimestamp
10) (integer) 1744254402895
11) chunkCount
12) (integer) 1
13) lastValue
14) (integer) 8
15) labels
16) 1) 1) "stockid"
      2) "A"
   2) 1) "issuer"
      2) "1"

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• filter：过滤条件。缓存数据库 Redis 版支持在自定义过滤条件（filter）中使用多种命令及命令组合，但需至少包含 EQ、CONTAINS、LIST_MATCH 逻辑中的任意 1 种。更多关于 filter 的详情，请参见条件查询语法。

返回值

• 执行成功将返回符合过滤条件的 Skey。
• 其它情况返回相应的异常信息。

示例

• 命令示例一
  从 Pkey test_exts 中筛选出 stockid 标签为 A 或 B，且 issuer 标签不为 1 的所有 Skey。

  EXTS.QUERYINDEX test_exts stockid=(A,B) issuer!=1
  

  返回示例。

  1) "closing_price"
  2) "volume2"
  

• 命令示例二
  从 Pkey test_exts 中筛选出所有包含 stockid 标签的 Skey。

  EXTS.QUERYINDEX test_exts stockid!=
  

  返回示例。

  1) "closing_price"
  2) "closing_price2"
  3) "volume1"
  4) "volume2"
  5) "isser"
  

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• Skey：Skey 名称。
• fromTimestamp：查询的开始时间，格式为 Unix 时间戳，单位：毫秒。
• toTimestamp：查询的结束时间，格式为 Unix 时间戳，单位：毫秒。允许用 *表示系统当前的时间戳，若该值等于 fromTimestamp，表示查询仅包含该时间点的 Datapoint 数据。
• COUNT：指定允许返回的 Datapoint 条数上限，取值不可超过 10 万。若该参数不填，表示最多允许返回 10 万条 Datapoint 数据。
• AGGREGATION：设置 Skey 的聚合查询条件，包括：
  • aggregationType：聚合类型，例如按最大值（MAX）、最小值（MIN）、平均值（AVG）等进行聚合。
  • timeBucket：采样间隔，单位：毫秒，采样间隔最小为 1,000 毫秒。
    缓存数据库 Redis 版会将采样间隔内的数据按照指定类型进行聚合并返回结果，返回的时间点为采样间隔的开始时间。例如，AGGREGATION MAX 3000 表示会返回每 3,000 毫秒内的最大值。关于聚合查询语法的更多详情，请参见聚合查询语法。

返回值

• 执行成功：返回符合查询条件的 Datapoint 数据，若命令中指定了聚合查询条件，则返回聚合后的结果。
• 其它情况返回相应的异常信息。

示例

从 Pkey test_exts 的 Skey closing_price 中查询出指定时间段内每 3,000 毫秒的最大值，且最多允许返回 2 条数据。

EXTS.RANGE test_exts closing_price 1743566159000 * COUNT 2 AGGREGATION MAX 3000

返回示例。

1) 1) 1) (integer) 1744255152000
      2) "73"
   2) 1) (integer) 1744255167000
      2) "76"
2) (integer) 1

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• fromTimestamp：查询的开始时间，格式为 Unix 时间戳，单位：毫秒。
• toTimestamp：查询的结束时间，格式为 Unix 时间戳，单位：毫秒。允许用 *表示系统当前的时间戳，若该值等于 fromTimestamp，表示查询仅包含该时间点的 Datapoint 数据。
• COUNT：指定允许返回的 Datapoint 条数上限，取值不可超过 10 万。若该参数不填，表示最多允许返回 10 万条 Datapoint 数据。
• AGGREGATION：设置 Skey 的聚合查询条件，包括：
  • aggregationType：聚合类型，例如按最大值（MAX）、最小值（MIN）、平均值（AVG）等进行聚合。
  • timeBucket：采样间隔，单位：毫秒，采样间隔最小为 1,000 毫秒。
    缓存数据库 Redis 版会将采样间隔内的数据按照指定类型进行聚合并返回结果，返回的时间点为采样间隔的开始时间。例如，AGGREGATION MAX 3000 表示会返回每 3,000 毫秒内的最大值。关于聚合查询语法的更多详情，请参见聚合查询语法。
• WITHLABELS：设置返回结果中是否包含标签信息。若该参数不填，表示默认不显示标签信息。
• Filter：过滤条件。缓存数据库 Redis 版支持在自定义过滤条件（filter）中使用多种命令及命令组合，但需至少包含 EQ、CONTAINS、LIST_MATCH 逻辑中的任意 1 种。更多关于 filter 的详情，请参见条件查询语法。

返回值

• 执行成功：返回符合查询条件的 Skey 信息列表。
• 其它情况返回相应的异常信息。

示例

• 命令示例一
  从 Pkey test_exts 查询出指定时间段内每 3,000 毫秒的总和，且包含标签 stockid 为 B 的 Skey 信息列表，且每个 Skey 最多允许返回 2 条 Datapoint 数据。

  EXTS.MRANGE test_exts 1743566159000 * COUNT 2 AGGREGATION SUM 3000 FILTER stockid=B
  

  返回示例。

  1) 1) "closing_price"
     2) (empty array)
     3) 1) 1) (integer) 1744254909000
           2) "107"
     4) (integer) 0
  2) 1) "closing_price2"
     2) (empty array)
     3) 1) 1) (integer) 1744255152000
           2) "73"
        2) 1) (integer) 1744255167000
           2) "76"
     4) (integer) 1
  3) 1) "volume"
     2) (empty array)
     3) 1) 1) (integer) 1744254906000
           2) "107"
     4) (integer) 0
  

• 命令示例二
  从 Pkey test_exts 查询出指定时间段内每 5,000 毫秒的 value 数量，需要包含标签 stockid 为 B 但 issuer 不为 1 的 Skey 信息列表，且需要在返回结果中展示标签信息。

  EXTS.MRANGE test_exts 1743566159000 * AGGREGATION COUNT 5000 WITHLABELS FILTER stockid=B issuer!=1
  

  返回示例。

  1) 1) "volume"
     2) 1) 1) "stockid"
           2) "B"
        2) 1) "issuer"
           2) "2"
     3) 1) 1) (integer) 1744254900000
           2) "1"
     4) (integer) 0
  

命令描述

在目标 Pkey 中对指定时间段内，符合自定义过滤条件（filter）的 Datapoint 数据进行 Pkey 层级的聚合。
若您同时指定了 Pkey 和 Skey 层级的聚合，会优先对 Skey 层级进行聚合（使用方法与 EXTS.MRANGE 命令相同），再从 Pkey 层级对第一次聚合结果进行二次聚合。

选项

• Pkey：Pkey 名称，用于指定作为命令调用对象的 ExTimeSeries。
• pkeyAggregationType：Pkey 的聚合类型。关于聚合查询语法的更多详情，请参见聚合查询语法。
• pkeyTimeBucket：Pkey 的采样间隔，单位：毫秒，采样间隔最小为 1,000 毫秒。
• fromTimestamp：查询的开始时间，格式为 Unix 时间戳，单位：毫秒。
• toTimestamp：查询的结束时间，格式为 Unix 时间戳，单位：毫秒。允许用 *表示系统当前的时间戳，若该值等于 fromTimestamp，表示查询仅包含该时间点的 Datapoint 数据。
• COUNT：指定允许返回的 Datapoint 条数上限，取值不可超过 10 万。若该参数不填，表示最多允许返回 10 万条 Datapoint 数据。
• AGGREGATION：设置 Skey 的聚合查询条件，包括：
  • aggregationType：聚合类型，例如按最大值（MAX）、最小值（MIN）、平均值（AVG）等进行聚合。
  • timeBucket：采样间隔，单位：毫秒，采样间隔最小为 1,000 毫秒。
    缓存数据库 Redis 版会将采样间隔内的数据按照指定类型进行聚合并返回结果，返回的时间点为采样间隔的开始时间。例如，AGGREGATION MAX 3000 表示会返回每 3,000 毫秒内的最大值。关于聚合查询语法的更多详情，请参见聚合查询语法。
• WITHLABELS：设置返回结果中是否包含标签信息。若该参数不填，表示默认不显示标签信息。
• Filter：过滤条件。缓存数据库 Redis 版支持在自定义过滤条件（filter）中使用多种命令及命令组合，但需至少包含 EQ、CONTAINS、LIST_MATCH 逻辑中的任意 1 种。更多关于 filter 的详情，请参见条件查询语法。

返回值

• 执行成功：返回符合查询条件聚合结果。
• 其它情况返回相应的异常信息。

示例

在 Pkey test_exts 中，对指定时间段内的 Datapoint 数据进行如下聚合操作：

• Datapoint 数据需来自于包含了标签 stockid 为 B 的 Skey，且每个 Skey 最多允许返回 2 条 Datapoint 数据。
• 先将筛选出的 Datapoint 数据在 Skey 层级进行每 3,000 毫秒的求和。
• 再将上述聚合过的数据在 Pkey 层级进行每 5,000 毫秒的求和。

EXTS.PRANGE test_exts 1743566159000 * SUM 5000 COUNT 2 AGGREGATION SUM 3000 FILTER stockid=B

返回示例。

1) 1) 1) (integer) 1744254905000
      2) "214"
   2) 1) (integer) 1744255150000
      2) "73"
2) (integer) 1