Tair：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數，預設值為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

類別

說明

文法

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可儲存的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

類別

說明

文法

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可儲存的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

類別

說明

文法

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可儲存的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"

類別

說明

文法

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可儲存的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

類別

說明

文法

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] [WITHLABELS] 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會將該時間範圍內的資料進行彙總並返回一個結果，返回的時間點為採樣間隔的開始時間。

• 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

類別

說明

文法

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可儲存的Datapoint數，預設值為256條，取值範圍為[1,256]。

• 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可儲存的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

類別

說明

文法

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可儲存的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"

類別

說明

文法

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可儲存的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

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