Tair (Redis® OSS-Compatible):Cpc

パラメーター

説明

構文

CPC.UPDATEキーアイテム [EX | EXAT | PX | PXAT時間]

時間の複雑さ

O(1)

コマンド説明

指定されたTairCpcキーにアイテムを追加します。 キーが存在しない場合は、キーが作成されます。 アイテムがすでにキーに存在する場合、アイテムは追加されません。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

Output

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

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

例：

サンプルコマンド:

CPC.UPDATE foo f1 EX 3600

サンプル出力：

OK

パラメーター

説明

構文

CPC.ESTIMATEキー

時間の複雑さ

O(1)

コマンド説明

重複排除後に指定されたTairCpcキーのカーディナリティ推定値を取得します。 戻り値はDOUBLE型ですが、小数を無視して最も近い整数に丸めることができます。

パラメーター

• key: TairCpcキーの名前。

Output

• 操作が成功した場合、DOUBLEタイプの見積もりが返されます。

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

例：

サンプルコマンド:

CPC.ESTIMATE foo

サンプル出力：

「19.000027716212127」

パラメーター

説明

構文

CPC.UPDATE2ESTキーアイテム [EX | EXAT | PX | PXAT時間]

時間の複雑さ

O(1)

コマンド説明

指定されたTairCpcキーに項目を追加し、更新後のキーの新しいカーディナリティ推定値を返します。 キーが存在しない場合は、キーが作成されます。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

Output

• 操作が成功した場合、更新後のDOUBLEタイプの見積もりが返されます。

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

例：

サンプルコマンド:

CPC.UPDATE2EST foo f3

サンプル出力：

「3.0000004768373003」

パラメーター

説明

構文

CPC.UPDATE2JUDキーアイテム [EX | EXAT | PX | PXAT時間]

時間の複雑さ

O(1)

コマンド説明

指定されたTairCpcキーに項目を追加し、更新後のキーの新しいカーディナリティ推定値と、元の推定値と新しい推定値の差を返します。 アイテムが追加され、重複が存在しない場合、1の差が返されます。 アイテムが既に存在する場合、0の差が返されます。 キーが存在しない場合は、キーが作成されます。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

Output

• 操作が成功した場合、更新後の新しい推定値と、元の推定値と新しい推定値の差が返されます。 新しい推定値と差は両方ともDOUBLEタイプです。

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

例：

サンプルコマンド:

CPC.UPDATE2JUD foo f20

サンプル出力：

1) "20.000027716212127"    // The new cardinality estimate of the key after the update is 20. 
2) "1.0000014901183398"    // 20 - 19 = 1

パラメーター

説明

構文

CPC.ARRAY.UPDATE key timestamp item [EX | EXAT | PX | PXAT時間] [サイズサイズ] [WIN window_length]

時間の複雑さ

O(1)

コマンド説明

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• timestamp: UNIXタイムスタンプ。 単位：ミリ秒。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• SIZE: タイムウィンドウの数。 デフォルト値は 10 です。 有効な値: 1 ~ 1000 このパラメーターを120未満の値に設定することを推奨します。

• WIN: 各時間ウィンドウの長さ。 単位：ミリ秒。 デフォルト値: 60000 60000ミリ秒は1分に等しい。

Output

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

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

例：

サンプルコマンド:

CPC.ARRAY.UPDATE foo 1645584510000 f1 SIZE 120 WIN 10000

サンプル出力：

OK

パラメーター

説明

構文

CPC.ARRAY.ESTIMATE key timestamp

時間の複雑さ

O(1)

コマンド説明

指定されたタイムスタンプが属する時間ウィンドウ内の指定されたTairCpcキーのカーディナリティ推定値を取得します。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• timestamp: UNIXタイムスタンプ。 単位：ミリ秒。

Output

• 操作が成功した場合、時間ウィンドウ内のキーの濃度推定値が返されます。

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

例：

サンプルコマンド:

CPC.ARRAY。ESTIMATE foo 1645584532000

サンプル出力：

"2"

パラメーター

説明

構文

CPC.ARRAY.ESTIMATE.RANGEキーstart_time end_time

時間の複雑さ

O(1)

コマンド説明

指定された時間範囲内の時間ウィンドウ全体で、指定されたTairCpcキーのカーディナリティ推定値を取得します。 時間範囲は、閉じた間隔である。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

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

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

Output

• 操作が成功した場合、時間ウィンドウにわたるキーの濃度推定値が返されます。

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

例：

サンプルコマンド:

CPC.ARRAY.ESTIMATE.RANGE foo 1645584510000 1645584550000

サンプル出力：

1) "2"
2) "0"
3) "1"
4) "0"
5) "0" 

パラメーター

説明

構文

CPC.ARRAY.ESTIMATE.RANGE.MERGE key timestamp range

時間の複雑さ

O(1)

コマンド説明

特定の時点からN番目の時間ウィンドウまでのマージおよび重複排除後に、指定されたTairCpcキーのカーディナリティ推定値を取得します。 Nは范囲パラメータの値です。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

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

• range: クエリする時間ウィンドウの数。

Output

• 操作が成功した場合、指定された時間範囲内の重複排除後のキーの濃度推定値が返されます。

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

例：

サンプルコマンド:

CPC.ARRAY.ESTIMATE.RANGE.MERGE foo 1645584510000 3

サンプル出力：

"6"

パラメーター

説明

構文

CPC.ARRAY.UPDATE2ESTキータイムスタンプアイテム [EX | EXAT | PX | PXAT時間] [サイズサイズ] [WIN window_length]

時間の複雑さ

O(1)

コマンド説明

指定されたタイムスタンプが属する時間ウィンドウに、指定されたTairCpcキーで項目を追加し、更新後の時間ウィンドウ内のキーの新しい濃度推定値を返します。 キーが存在しない場合は、キーが作成されます。 このコマンドは、CPC.ARRAY.UPDATEコマンドで使用されたパラメータと一致するパラメータを使用してキーを作成します。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• timestamp: UNIXタイムスタンプ。 単位：ミリ秒。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• SIZE: タイムウィンドウの数。 デフォルト値は 10 です。 有効な値: 1 ~ 1000 このパラメーターを120未満の値に設定することを推奨します。

• WIN: 各時間ウィンドウの長さ。 単位：ミリ秒。 デフォルト値: 60000 60000ミリ秒は1分に等しい。

Output

• 操作が成功した場合、更新後の新しい濃度推定値が返されます。

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

例：

サンプルコマンド:

CPC.ARRAY.UPDATE2EST foo 1645584530000 f3

サンプル出力：

"3"

パラメーター

説明

構文

CPC.ARRAY.UPDATE2JUDキータイムスタンプアイテム [EX | EXAT | PX | PXAT時間] [サイズサイズ] [WIN window_length]

時間の複雑さ

O(1)

コマンド説明

指定されたタイムスタンプが属する時間ウィンドウに、指定されたTairCpcキーで項目を追加し、更新後の時間ウィンドウ内のキーの新しい濃度推定値と、元の推定値と新しい推定値の差を返します。 アイテムが追加され、重複が存在しない場合、1の差が返されます。 アイテムが既に存在する場合、0の差が返されます。 キーが存在しない場合は、キーが作成されます。 このコマンドは、CPC.ARRAY.UPDATEコマンドで使用されたパラメータと一致するパラメータを使用してキーを作成します。

パラメーター

• key: このコマンドを実行して管理するTairCpcキーの名前。

• timestamp: UNIXタイムスタンプ。 単位：ミリ秒。

• item: 追加するアイテム。

• EX: キーの相対有効期限 (秒) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• EXAT: キーの絶対有効期限 (秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PX: キーの相対有効期限 (ミリ秒単位) 。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• PXAT: キーの絶対有効期限 (ミリ秒) 。 値はUNIXタイムスタンプである必要があります。 このパラメーターが指定されていない場合、キーは期限切れになりません。

• SIZE: タイムウィンドウの数。 デフォルト値は 10 です。 有効な値: 1 ~ 1000 このパラメーターを120未満の値に設定することを推奨します。

• WIN: 各時間ウィンドウの長さ。 単位：ミリ秒。 デフォルト値: 60000 60000ミリ秒は1分に等しい。

Output

• 操作が成功した場合、更新後の時間ウィンドウ内の新しい推定値と、元の推定値と新しい推定値の差が返されます。

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

例：

サンプルコマンド:

CPC.ARRAY.UPDATE2JUD foo 1645584530000 f7

サンプル出力：

1) "8"            // The new cardinality estimate of the key after the update is 8. 
2) "1"            // 8 - 7 = 1