Memcached add コマンド
Memcached add コマンドは、value(データ値)を指定されたkey(キー)に格納するために使用されます。
add の key がすでに存在する場合、データは更新されません(期限切れの key は更新されます)。以前の値はそのまま保持され、応答が返ります。NOT_STORED。
構文:
add コマンドの基本構文は次のとおりです:
add key flags exptime bytes [noreply] value
パラメータの説明は次のとおりです:
- key:キーと値(key-value)構造における key で、キャッシュ値を検索するために使用します。
- flags:キーと値のペアを含む整数型パラメータで、クライアントがキーと値のペアに関する追加情報を保存するために使用します。
- exptime:キャッシュ内にキーと値のペアを保存する時間(秒単位、0 は無期限を意味します)
- bytes:キャッシュに保存するバイト数
- noreply(オプション):このパラメータは、サーバーがデータを返す必要がないことを伝えます
- value:保存する値(常に2行目にあります)(key-value 構造における value と直接理解できます)
例
次の例では、以下のように設定します:
- key → new_key
- flag → 0
- exptime → 900(秒単位)
- bytes → 10(データ保存のバイト数)
- value → data_value
add new_key 0 900 10 data_value STORED get new_key VALUE new_key 0 10 data_value END
出力
データの追加が成功すると、次のように出力されます:
STORED
出力情報の説明:
- STORED:保存成功後に出力されます。
- NOT_STORED :保存失敗後に出力されます。