Key-value item은 하나의 key에 대해 하나의 value만을 저장하는 item이다.
제약조건
Key의 최대 크기는 4000 character이다.
Cache item의 최대 크기는 1MB이다.
Key-value item에 대해 수행 가능한 연산들은 아래와 같다.
Key-Value Item 저장
key-value item을 저장하는 API로 set, add, replace, prepend/append가 있다.
memcached_return_t
memcached_set(memcached_st *ptr,
const char *key, size_t key_length,
const char *value, size_t value_length,
time_t expiration, uint32_t flags)
memcached_return_t
memcached_add(memcached_st *ptr,
const char *key, size_t key_length,
const char *value, size_t value_length,
time_t expiration, uint32_t flags)
memcached_return_t
memcached_replace(memcached_st *ptr,
const char *key, size_t key_length,
const char *value, size_t value_length,
time_t expiration, uint32_t flags)
memcached_set: 주어진 key에 value를 저장한다.
memcached_add: 주어진 key가 존재하지 않을 경우에만 value를 저장한다.
memcached_replace: 주어진 key가 존재하는 경우에만 value를 저장한다.
memcached_return_t
memcached_prepend(memcached_st *ptr,
const char *key, size_t key_length,
const char *value, size_t value_length,
time_t expiration, uint32_t flags)
memcached_return_t
memcached_append(memcached_st *ptr,
const char *key, size_t key_length,
const char *value, size_t value_length,
time_t expiration, uint32_t flags)
memcached_prepend: 주어진 key의 value에 새로운 데이터를 prepend한다.
memcached_append: 주어진 key의 value에 새로운 데이터를 append한다.
Key-value item 저장 연산에서 주요 파라미터는 아래와 같다.
expiration: key가 현재 시간부터 expire 될 때까지의 시간(초 단위). 시간이 30일을 초과하는 경우 expire 될 unix time을 입력한다.
0: key가 expire 되지 않도록 설정한다. 하지만 ARCUS cache server의 메모리가 부족한 경우 LRU에 의해 언제든지 삭제될 수 있다.
-1: key를 sticky item으로 만든다. Sticky item은 expire 되지 않으며 LRU에 의해 삭제되지도 않는다.
flags: value와는 별도로 저장할 수 있는 값으로서 Java client 등에서 내부적으로 사용하는 경우가 많으므로 사용하지 않기를 권한다.
Key-Value Item 조회
Key-value item을 조회하는 API는 두 가지가 있다.
char *
memcached_get(memcached_st *ptr,
const char *key, size_t key_length,
size_t *value_length, uint32_t *flags,
memcached_return_t *error)
주어진 key에 대한 value를 조회한다. 반환된 결과는 NULL이 아닌 경우 반드시 free 해주어야 한다.
memcached_return_t
memcached_mget(memcached_st *ptr,
const char * const *keys, const size_t *key_length,
size_t number_of_keys)
char *
memcached_fetch(memcached_st *ptr,
char *key, size_t *key_length,
size_t *value_length, uint32_t *flags,
memcached_return_t *error)
memcached_mget은 주어진 key 배열에 대한 value들을 조회하는 요청을 보낸다. keys 인자는 key pointer array이고, key_length 인자는 key length array이다.
memcached_fetch는 mget 요청에 대한 결과를 하나씩 꺼내온다. error 값이 MEMCACHED_END가 될 때까지 실행하면 되며, 그 이후에 fetch를 수행하면 MEMCACHED_NOTFOUND가 반환된다.
Key-Value Item 값의 증감
Key-value item에서 숫자형 value 값에 대해서만 아래 증감 연산을 수행할 수 있다.
memcached_return_t
memcached_increment(memcached_st *ptr,
const char *key, size_t key_length,
uint32_t offset, uint64_t *value)
memcached_return_t
memcached_decrement(memcached_st *ptr,
const char *key, size_t key_length,
uint32_t offset, uint64_t *value)
주어진 key의 value를 offset 만큼 증가/감소 시킨다. 주어진 key가 존재하지 않으면, 오류를 낸다.
memcached_return_t
memcached_increment_with_initial(memcached_st *ptr,
const char *key, size_t key_length, uint64_t offset,
uint64_t initial, uint32_t flags, time_t expiration,
uint64_t *value)
memcached_return_t
memcached_decrement_with_initial(memcached_st *ptr,
const char *key, size_t key_length, uint64_t offset,
uint64_t initial, uint32_t flags, time_t expiration,
uint64_t *value)
주어진 key의 value를 offset 만큼 증가/감소 시킨다. 주어진 key가 존재하지 않으면, initial 값으로 저장한다.
Key-Value Item 삭제
memcached_return_t
memcached_delete(memcached_st *ptr,
const char *key, size_t key_length,
time_t expiration)
주어진 key를 삭제한다. expiration 값이 0 이상으로 지정되면 key는 expiration 초 이후에 삭제된다.
