閱讀556 返回首頁    go 技術社區[雲棲]

雲數據庫Memcache支持的API__API使用文檔_雲數據庫 Memcache 版-阿裏雲

請注意：以下協議為元操作，不同客戶端封裝後會有增減或修改。請以相應客戶端操作的定義為準。

存儲命令

操作 備注
Add 表示如果服務器沒有保存該關鍵字的情況下，存儲該數據
Replace 表示在服務器已經擁有該關鍵字的情況下，替換原有內容
Set 表示存儲該數據
Cas 表示僅當數據從上次獲取後沒有被其它程序修改過的時候才存儲

樣例

<command name> <key> <flags> <exptime> <bytes>"r"n

<data block>"r"n

<cas> <key> <flags> <exptime> <bytes> <cas unique>"r"n

<data block>"r"n

說明

<command name> 是 set、add或者replace。<key>是客戶端要求服務器存儲數據的關鍵字。

<flags>是一個16位的無符號整數，服務器將它和數據一起存儲並且當該數據被檢索時一起返回。客戶端可能使用該數值作為一個位圖來存儲特殊數據信息；這個字段對服務器不是透明的。

<exptime>是超時時間。如果值為0表示該數據項永遠不超時（但有時候該數據項可能被刪除以為其他數據騰出空間）；如果值不為0，可能是絕對的UNIX時間，也可能是自現在開始的偏移值，它保證客戶段在這個超時時間到達後，客戶端將取不到該數據項。

<bytes>是隨後數據的字節數，不包括終結符”"r"n”。<bytes>有可能是0，它後麵將是一個空的數據塊。

<data block>是真正要存儲數據流。

<cas unique>是對應該版本item的唯一標識符，需通過gets接口獲取後再傳入cas命令。

讀取操作

操作 備注
Get 獲取Key的Value

樣例 get <key>*"r"n

說明 <key>*表示一個或多個使用空格分割的關鍵字字符串

刪除操作

操作 備注
Delete 刪除命令允許直接刪除數據項

樣例

delete <key> <time>"r"n

說明

<key>是客戶端希望服務器刪除數據項的關鍵字

<time>是客戶端希望服務器阻止add和replace命令使用該關鍵字數據項的秒數，可以是相對時間也可以是UNIX的絕對時間。在這段時間內，數據項被放入一個刪除隊列，它不能被get命令讀取，在其上使用add和replace也會失敗，但使用set命令可以成功。當這個時間過去後，數據項從服務器的內存中真正的刪除。該參數是可選參數，如果不存在默認為0，這意味著立即從服務器上刪除。

其他操作

操作 備注
Increment/ Decrement 命令用來修改以及存在的數據項的內容，增加或者減少它。該數據被當作32位無符號整數處理。如果當前數據非此類數據，則經將該內容當作0來處理。另外在其上施加incr/decr命令的數據項必須是業已存在的；對於不存在的數據項不會將它作為0對待，而是以錯誤結束
Version 獲取服務器版本信息
Append 在Valu後追加字符
Prepend 在Value前追加字符
No-op 無操作，調試用
Quit 當服務器接受到此命令後，就關閉與該客戶的連接

最後更新：2016-11-23 17:16:03

  上一篇：go 支持的協議及操作__快速入門_雲數據庫 Memcache 版-阿裏雲
  下一篇：go 產品名詞__產品介紹_雲數據庫 PetaData-阿裏雲