Tair (Redis® OSS-Compatible)：Cpc

類別

說明

文法

CPC.UPDATE key item [EX|EXAT|PX|PXAT time]

時間複雜度

O(1)

命令描述

在指定TairCpc中添加item。若TairCpc不存在則自動建立，若待添加的item已存在於目標TairCpc中，則不會進行操作。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

傳回值

• OK：表示執行成功。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.UPDATE foo f1 EX 3600

返回樣本：

OK

類別

說明

文法

CPC.ESTIMATE key

時間複雜度

O(1)

命令描述

擷取指定TairCpc去重後的基數估算值，傳回值的資料類型為double類型，您可以僅取整數部分（忽略小數點後的資料）。

選項

• key：Key名稱（TairCpc資料結構）。

傳回值

• 執行成功：返回估算值，資料類型為double類型。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.ESTIMATE foo

返回樣本：

"19.000027716212127"

類別

說明

文法

CPC.UPDATE2EST key item [EX|EXAT|PX|PXAT time]

時間複雜度

O(1)

命令描述

在指定TairCpc中添加item，返回更新後的基數估算值。若TairCpc不存在則自動建立。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

傳回值

• 執行成功：返回更新後的估算值，資料類型為double類型。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.UPDATE2EST foo f3

返回樣本：

"3.0000004768373003"

類別

說明

文法

CPC.UPDATE2JUD key item [EX|EXAT|PX|PXAT time]

時間複雜度

O(1)

命令描述

在指定TairCpc中添加item，並返回更新後的基數估算值和其與更新前的差值。若返回的差值為1則表示寫入成功且不存在重複；若為0則表示已存在當前item。若TairCpc不存在則自動建立。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

傳回值

• 執行成功：返回更新後的估算值和該值與更新前的差值，資料類型均為double類型。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.UPDATE2JUD foo f20

返回樣本：

1) "20.000027716212127"    // 更新後，TairCpc的估算值為20。
2) "1.0000014901183398"    // 20 - 19 = 1

類別

說明

文法

CPC.ARRAY.UPDATE key timestamp item [EX|EXAT|PX|PXAT time] [SIZE size] [WIN window_length]

時間複雜度

O(1)

命令描述

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• timestamp：指定的Unix時間戳記，單位為毫秒。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

• SIZE：時間視窗個數，預設為10，範圍為[1,1000]，建議設定在120以內。

• WIN：時間視窗的長度（單位為毫秒），預設為60000毫秒（1分鐘）。

傳回值

• OK：表示執行成功。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

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

返回樣本：

OK

類別

說明

文法

CPC.ARRAY.ESTIMATE key timestamp

時間複雜度

O(1)

命令描述

擷取指定TairCpc中目標timestamp所在時間視窗的基數估算值。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• timestamp：指定的Unix時間戳記，單位為毫秒。

傳回值

• 執行成功：返回對應時間視窗的基數估算值。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.ARRAY.ESTIMATE foo 1645584532000

返回樣本：

"2"

類別

說明

文法

CPC.ARRAY.ESTIMATE.RANGE key start_time end_time

時間複雜度

O(1)

命令描述

擷取指定TairCpc的指定時間段內（包含指定時間點）各個時間視窗的基數估算值。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• start_time：查詢的開始時間（Unix時間戳記），單位為毫秒。

• end_time：查詢的結束時間（Unix時間戳記），單位為毫秒。

傳回值

• 執行成功：返回目標時間視窗的基數估算值。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

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)

命令描述

擷取指定TairCpc在指定時間點至往前range（含當前視窗）個時間視窗內，時間視窗合并、去重後的基數估算值。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• timestamp：查詢的開始時間（Unix時間戳記），單位為毫秒。

• range：查詢的時間視窗個數。

傳回值

• 執行成功：返回目標key在指定時間段內去重後的基數估算值。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

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

返回樣本：

"6"

類別

說明

文法

CPC.ARRAY.UPDATE2EST key timestamp item [EX|EXAT|PX|PXAT time] [SIZE size] [WIN window_length]

時間複雜度

O(1)

命令描述

在指定TairCpc中，向目標timestamp對應的時間視窗添加item，並返回該時間視窗更新後的基數估算值。若TairCpc不存在則自動建立，建立參數用法與CPC.ARRAY.UPDATE一致。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• timestamp：指定的Unix時間戳記，單位為毫秒。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

• SIZE：時間視窗個數，預設為10，範圍為[1,1000]，建議設定在120以內。

• WIN：時間視窗的長度（單位為毫秒），預設為60000毫秒（1分鐘）。

傳回值

• 執行成功：返回目標時間視窗更新後的估算值。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.ARRAY.UPDATE2EST foo 1645584530000 f3

返回樣本：

"3"

類別

說明

文法

CPC.ARRAY.UPDATE2JUD key timestamp item [EX|EXAT|PX|PXAT time] [SIZE size] [WIN window_length]

時間複雜度

O(1)

命令描述

在指定TairCpc中，向目標timestamp對應的時間視窗添加item，並返回該時間視窗更新後的基數估算值和其與更新前的差值。若返回的差值為1，則表示寫入成功且不存在重複；若為0則表示已存在當前item。若TairCpc不存在則自動建立，建立參數用法與CPC.ARRAY.UPDATE一致。

選項

• key：Key名稱（TairCpc資料結構），用於指定命令調用的TairCpc對象。

• timestamp：指定的Unix時間戳記，單位為毫秒。

• item：待添加的資料。

• EX：指定key的相對到期時間，單位為秒，不傳此參數表示不到期。

• EXAT：指定key的絕對到期時間（Unix時間戳記），單位為秒，不傳此參數表示不到期。

• PX：指定key的相對到期時間，單位為毫秒，不傳此參數表示不到期。

• PXAT：指定key的絕對到期時間（Unix時間戳記），單位為毫秒 ，不傳此參數表示不到期。

• SIZE：時間視窗個數，預設為10，範圍為[1,1000]，建議設定在120以內。

• WIN：時間視窗的長度（單位為毫秒），預設為60000毫秒（1分鐘）。

傳回值

• 執行成功：返回目標時間視窗更新後的估算值和該值與更新前的差值。

• 其它情況返回相應的異常資訊。

樣本

命令樣本：

CPC.ARRAY.UPDATE2JUD foo 1645584530000 f7

返回樣本：

1) "8"            // 更新後，TairCpc的估算值為8。
2) "1"            // 8 - 7 = 1