Tair (Redis® OSS-Compatible):TS

項目

説明

構文

EXTS.P.CREATE Pkey

時間の複雑さ

O(1)

コマンド説明

TairTS pkeyを作成します。 同じ名前のpkeyがすでに存在する場合、pkeyは作成できません。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.P.CREATE foo

サンプル出力：

OK

項目

説明

構文

EXTS.S.CREATE Pkey Skey [DATA_ET時間] [CHUNK_SIZEサイズ] [圧縮なし] [LABELS label1 val1 label2 val2 ...]

時間の複雑さ

O(1)

コマンド説明

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

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

サンプル出力：

OK

項目

説明

構文

EXTS.S.ALTER Pkey Skey [DATA_ET時間]

時間の複雑さ

O(1)

コマンド説明

指定したskeyのメタデータを変更します。 DATA_ET時間値のみを変更できます。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

Output

• 操作が成功した場合、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に挿入します。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 skeyのパラメーター (有効期限や圧縮を有効にするかどうかなど) は、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• ts: データポイントのUNIXタイムスタンプ。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。

• value: データポイントの値。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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時間] [CHUNK_SIZEサイズ] [圧縮なし] [LABELS label1 val1 ...]

時間の複雑さ

ここで、nはskeyの数を示す。

コマンド説明

データポイントをpkeyの複数のskeyに挿入します。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 有効期限や圧縮を有効にするかどうかなどのskeyのパラメーターは、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• keynumber: skeyの数。

• Skey: skeyの名前。

• ts: データポイントのUNIXタイムスタンプ。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。

• value: データポイントの値。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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サイズ] [圧縮されていない] [LABELS label1 val1 ...]

時間の複雑さ

O(1)

コマンド説明

データポイントをskeyに挿入します。 挿入するデータポイントの値が正の場合、skeyに存在する最後のデータポイントの値に挿入された値が加算されます。 データ点が負の値を有する場合、挿入された値は、skeyに存在する最後のデータ点の値から減算される。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 デフォルトの初期値は0です。 skeyのパラメーター (有効期限や圧縮を有効にするかどうかなど) は、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• ts: データポイントのUNIXタイムスタンプ。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。

• value: データポイントの値に追加する値です。 値は負にすることができます。 この場合、値はデータポイント値から減算される。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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時間] [CHUNK_SIZEサイズ] [圧縮なし] [LABELS label1 val1 ...]

時間の複雑さ

ここで、nはskeyの数を示す。

コマンド説明

データポイントをpkeyの複数のskeyに挿入します。 挿入するデータポイントの値が正の場合、挿入された値は各skeyに存在する最後のデータポイントの値に加算されます。 データ点が負の値を有する場合、挿入された値は、各skeyに存在する最後のデータ点の値から減算される。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 デフォルトの初期値は0です。 有効期限や圧縮を有効にするかどうかなどのskeyのパラメーターは、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• keynumber: skeyの数。

• Skey: skeyの名前。

• ts: データポイントのUNIXタイムスタンプ。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。

• value: データポイントの値に追加する値です。 値は負にすることができます。 この場合、値はデータポイント値から減算される。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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)

コマンド説明

skeyとskey内のすべてのデータポイントをpkeyから削除します。

項目

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.DEL foo temperature

サンプル出力：

OK

項目

説明

構文

EXTS.S.GET Pkey Skey

時間の複雑さ

O(1)

コマンド説明

指定したskeyの最後のデータポイントの値を照会します。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

Output

• 操作が成功した場合、データポイントの値が返されます。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.GET foo temperature

サンプル出力：

1) (integer) 1644372730150
2) "32.2"

項目

説明

構文

EXTS.S.INFO Pkey Skey

時間の複雑さ

O(1)

コマンド説明

指定したskeyのメタデータを照会します。 メタデータは、データポイントの数、最後のデータポイントのタイムスタンプおよび値、およびskeyのラベル情報を含む。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

Output

• 操作が成功した場合、skeyのメタデータが返されます。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.INFO foo temperature

サンプル出力：

1) totalDataPoints            // The number of data points. 
 2) (integer) 1
 3) maxDataPoints              // The maximum number of data points that can be stored in the skey. The default value is 0, which indicates that no upper limit is imposed. 
 4) (integer) 0
 5) maxDataPointsPerChunk      // The number of data points that can be stored in a chunk. 
 6) (integer) 32
 7) dataPointsExpireTime       // The relative expiration time of the skey. Unit: milliseconds. A value of 0 indicates that the skey does not expire. 
 8) (integer) 0
 9) lastTimestamp              // The timestamp of the last data point. 
10) (integer) 1644389400996
11) chunkCount                 // The number of chunks in the skey. 
12) (integer) 1
13) lastValue                  // The value of the last data point. 
14) (integer) 28
15) labels                     // The label information of the skey. 
16) 1) 1) "sensor_id"
       2) "1"

項目

説明

構文

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

時間の複雑さ

ここで、nは、フィルタ条件に含まれるセットの最大数を示す。

コマンド説明

pkeyで指定されたフィルター条件を満たすskeysを照会します。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• filter: フィルター条件。 skeysはラベルでフィルタリングできます。 詳細については、このトピックの「インデックスフィルタリング構文」を参照してください。

  説明

  フィルター条件を指定するときは、EQ、CONTAINS、LIST_MATCHのいずれかのロジックを使用する必要があります。 それ以外の場合、フィルタークエリは実行できません。

Output

• 操作が成功すると、指定されたフィルター条件を満たすskeyが返されます。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.QUERYINDEX foo sensor_id=1

サンプル出力：

1) "temperature"

項目

説明

構文

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

時間の複雑さ

ここで、nは、データポイントが属するチャンクの数を示す。

コマンド説明

指定された時間範囲内にskeyに存在するデータポイントの数を照会します。 時間範囲は、閉じた間隔である。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• fromTs: クエリする時間範囲の開始。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。

• toTs: クエリする時間範囲の終わり。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。 この値がfromTs値と等しい場合、ある時点がクエリに使用されます。

• MAXCOUNT: 返すデータポイントの数。 このパラメーターはデフォルトでは何も指定されていません。 Tairインスタンスの上限は1,000,000です。

• AGGREGATION:

  • aggregationType: MAX、AVG、SUMなどのアグリゲーションタイプ。詳細については、このトピックの「Aggregation syntax」を参照してください。

  • timeBucket: データの集計に使用されるタイムバケット。 単位：ミリ秒。 下限は1,000である。

    Tairは、複数のタイムバケットに存在するデータを集約し、単一の結果を返します。 返される時点は、各時間バケットの先頭です。

  たとえば、AGGREGATION AVG 5000は、指定された時間範囲内で5,000ミリ秒持続する各タイムバケットに存在するデータポイントの平均数を返します。

Output

• 操作が成功した場合、指定された時間範囲内にskeyに存在するデータポイントの数が返されます。 コマンドでAGGREGATIONパラメーターが指定されている場合、集計結果が返されます。

  説明

  追加のトークン値が返されます。 値0は、指定されたフィルター条件を満たすすべてのデータポイントが表示されることを示します。 値1は、指定されたフィルター条件を満たす特定のデータポイントが表示されないことを示します。 トークン値に基づいて、結果から最後のデータポイントを取得できます。 バッチ集計を実装するには、最後のデータポイントのタイムスタンプを次の時間範囲の先頭として使用してクエリを実行します。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.RANGE foo test 1644459031662 * AGGREGATION AVG 10000 MAXCOUNT 2
// The command retrieves the average number of data points that exist in each time bucket that lasts for 10,000 milliseconds within the specified time range and returns two data entries.

サンプル出力：

1) 1) 1) (integer) 1644459730000
      2) "20.6"
   2) 1) (integer) 1644459790000
      2) "21.2"
2) (integer) 1                    // A value of 0 indicates that all data points that meet specified filter conditions are displayed. A value of 1 indicates that specific data points that meet specified filtered conditions are not displayed.

項目

説明

構文

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

時間の複雑さ

ここで、nは、データポイントが属するチャンクの数を示す。

コマンド説明

指定された時間範囲内に複数のskeyで指定されたフィルター条件を満たすデータポイントの数を照会します。 時間範囲は、閉じた間隔である。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• fromTs: クエリする時間範囲の開始。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。

• toTs: クエリする時間範囲の終わり。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。 この値がfromTs値と等しい場合、ある時点がクエリに使用されます。

• MAXCOUNT: skeyで返すデータポイントの数。 このパラメーターはデフォルトでは何も指定されていません。 Tairインスタンスの上限は1,000,000です。

• AGGREGATION:

  • aggregationType: MAX、AVG、SUMなどのアグリゲーションタイプ。詳細については、このトピックの「Aggregation syntax」を参照してください。

  • timeBucket: データの集計に使用されるタイムバケット。 単位：ミリ秒。 下限は1,000である。

    Tairは、複数のタイムバケットに存在するデータを集約し、単一の結果を返します。 返される時点は、各時間バケットの先頭です。

• WITHLABELS: 出力にラベル情報を含めるかどうかを指定します。 このパラメーターはデフォルトでは空のままです。これは、ラベル情報が表示されないことを示します。

• filter: フィルター条件。 skeysはラベルでフィルタリングできます。 詳細については、このトピックの「インデックスフィルタリング構文」を参照してください。

  説明

  フィルター条件を指定するときは、EQ、CONTAINS、LIST_MATCHのいずれかのロジックを使用する必要があります。 それ以外の場合、フィルタークエリは実行できません。

Output

• 操作が成功すると、指定されたフィルター条件を満たすskeyが返されます。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

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カウント] [AGGREGATION aggregationType timeBucket] [WITHLABELS] FILTER filter1 [filter2 ...]

時間の複雑さ

ここで、nは、データポイントが属するチャンクの数を示す。

コマンド説明

指定されたフィルター条件を満たすpkeyのデータポイントを集計します。 集約に1つ以上のskeyを指定した場合、EXTS.S.MRANGEコマンドを使用した場合と同じ方法でskeyが最初に集約されます。 次に、skey集計結果に基づいてpkeysが集計されます。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• fromTs: クエリする時間範囲の開始。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。

• toTs: クエリする時間範囲の終わり。 この値はUNIXタイムスタンプである必要があります。 単位：ミリ秒。 * の値を使用して、現在の時刻のタイムスタンプを指定できます。 この値がfromTs値と等しい場合、ある時点がクエリに使用されます。

• pkeyAggregationType: pkeyの集計タイプ。 詳細については、このトピックの「Aggregation syntax」を参照してください。

• pkeyTimeBucket: pkeyのデータを集約するために使用されるタイムバケット。 単位：ミリ秒。 下限は1,000である。

  Tairは、複数のタイムバケットに存在するデータを集約し、単一の結果を返します。 返される時点は、各時間バケットの先頭です。

• MAXCOUNT: skeyで返すデータポイントの数。 このパラメーターはデフォルトでは何も指定されていません。 Tairインスタンスの上限は1,000,000です。

• AGGREGATION:

  • aggregationType: skeyの集計タイプ。 詳細については、このトピックの「Aggregation syntax」を参照してください。

  • timeBucket: skeyのデータを集約するために使用されるタイムバケット。 単位：ミリ秒。 下限は1,000である。

    Tairは、複数のタイムバケットに存在するデータを集約し、単一の結果を返します。 返される時点は、各時間バケットの先頭です。

• WITHLABELS: 出力にラベル情報を含めるかどうかを指定します。 このパラメーターはデフォルトでは空のままです。これは、ラベル情報が表示されないことを示します。

• filter: フィルター条件。 skeysはラベルでフィルタリングできます。 詳細については、このトピックの「インデックスフィルタリング構文」を参照してください。

  説明

  フィルター条件を指定するときは、EQ、CONTAINS、LIST_MATCHのいずれかのロジックを使用する必要があります。 それ以外の場合、フィルタークエリは実行できません。

Output

• 操作が成功した場合、集計結果が返されます。

• pkeyまたはskeyが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

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サイズ] [圧縮されていない] [LABELS label1 val1 ...]

時間の複雑さ

O(1)

コマンド説明

指定したskeyのデータポイントの値を変更します。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 skeyのパラメーター (有効期限や圧縮を有効にするかどうかなど) は、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• ts: 値を更新するデータポイントのUNIXタイムスタンプ。 単位：ミリ秒。

• value: 更新するデータポイントの値です。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXTS.S.RAW_MODIFY foo temperature 1644310456023 31.5

サンプル出力：

OK

項目

説明

構文

EXTS.S.RAW_MMODIFY Pkeyキー番号Skey ts value [Skey ts value ...] [DATA_ET時間] [CHUNK_SIZEサイズ] [圧縮なし] [LABELS label1 val1 ...]

時間の複雑さ

ここで、nはskeyの数を示す。

コマンド説明

複数のskeysのデータポイントの値を一度に変更します。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 有効期限や圧縮を有効にするかどうかなどのskeyのパラメーターは、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• keynumber: skeyの数。

• Skey: skeyの名前。

• ts: 値を更新するデータポイントのUNIXタイムスタンプ。 単位：ミリ秒。

• value: 更新するデータポイントの値です。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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サイズ] [圧縮されていない] [LABELS label1 val1 ...]

時間の複雑さ

O(1)

コマンド説明

指定したskeyのデータポイントの値を変更します。 値を変更するためのインクリメントまたはデクリメントを指定できます。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 デフォルトの初期値は0です。 skeyのパラメーター (有効期限や圧縮を有効にするかどうかなど) は、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• Skey: skeyの名前。

• ts: 値を更新するデータポイントのUNIXタイムスタンプ。 単位：ミリ秒。

• value: データポイントの値に追加する値です。 値は負にすることができます。 この場合、値はデータポイント値から減算される。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

事前にEXTS.S.ADD foo temperature 1644310456 30.0コマンドを実行します。

サンプルコマンド:

ｖ

サンプル出力：

OK

1) (integer) 1644310456
2) "33.3"

項目

説明

構文

EXTS.S.RAW_MINCRBY Pkeyキー番号Skey ts value [Skey ts value ...] [DATA_ET時間] [CHUNK_SIZEサイズ] [圧縮なし] [LABELS label1 val1 ...]

時間の複雑さ

ここで、nはskeyの数を示す。

コマンド説明

複数のskeysのデータポイントの値を一度に変更します。 値を変更するためのインクリメントまたはデクリメントを指定できます。 pkeyまたはskeyが存在しない場合、pkeyまたはskeyは自動的に作成されます。 有効期限や圧縮を有効にするかどうかなどのskeyのパラメーターは、skeyが自動的に作成された場合にのみ有効になります。

パラメーター

• Pkey: このコマンドを実行して管理するpkeyの名前。

• keynumber: skeyの数。

• Skey: skeyの名前。

• ts: 値を更新するデータポイントのUNIXタイムスタンプ。 単位：ミリ秒。

• value: データポイントの値に追加する値です。 値は負にすることができます。 この場合、値はデータポイント値から減算される。 値は倍精度浮動小数点数でなければなりません。

• DATA_ET time: データポイントの相対的な有効期限。 単位：ミリ秒。 このパラメーターはデフォルトでは空のままです。これは、データポイントが期限切れにならないことを示します。

• CHUNK_SIZE: チャンクに格納できるデータポイントの数。 デフォルト値: 256 有効な値: 1 ~ 256

• UNCOMPRESSED: skeyの圧縮を無効にすることを指定します。 このパラメーターはデフォルトでは空のままです。これは、skeyの圧縮が有効になっていることを示します。

• ラベル: skeyのラベル。 1つ以上のラベルと値のペアを指定できます。 例: LABELS sensor_id 1

Output

• 操作が成功した場合、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 (等しい)

L! =

ラベルLの値はNULLではなく、skeyにラベルLが含まれていることを示します。

含有量

L = (v1,v2,...)

ラベルLの値は、v1またはv2など、リスト内の値の1つと一致します。

LIST_TMATCH

L! =V

ラベルLの値はVに等しくない。

NOEQ (等しい)

L =

ラベルLの値はNULLです。これは、skeyにラベルLが含まれていないことを示します。

NOCONTAINS

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

ラベルLの値は、v1やv2など、リスト内のどの値とも一致しません。

LIST_NOTMATCH