Cluster

Redis CLUSTER GETKEYSINSLOT

레디스 클러스터 교육	레디스 정기점검/기술지원 Redis Technical Support	레디스 엔터프라이즈 서버 Redis Enterprise Server

Redis CLUSTER GETKEYSINSLOT

CLUSTER GETKEYSINSLOT slot count는 슬롯 번호에 속한 키들을 조회하는 명령이다.

이 문서는 버전 3.2.0을 기준으로 만들었습니다.

사용법

Slot 번호에 속한 키들을 조회한다.

127.0.0.1:7000> cluster getkeysinslot 4998 1
1) "key2"

확장 옵션 설명 [type] [len] [memory] [sort|asc|desc] [sum]

Type, len, memory, sort, asc, desc, sum 옵션을 사용할 수 있습니다.
TYPE: Data Type(string, list, set, zset, hash, stream)을 보여줍니다.
LEN: 키의 member 수를 보여줍니다. String은 1입니다.
MEMORY: 키가 사용하고 있는 메모리 크기를 보여줍니다.
SORT/ASC: 오름차순(ascending)으로 소트해서 보여줍니다.
DESC: 내림차순(descending)으로 소트해서 보여줍니다.
SUN: 키 개수, len, memory 합계를 보여줍니다. Type에 대한 sum은 빈 문자열입니다.

cluster getkeysinslot

127.0.0.1:6000> cluster keyslot mylist1
(integer) 3979
127.0.0.1:6000> cluster getkeysinslot 3979 1 type len memory
1) "mylist1"
2) "list"
3) "4"
4) "153"
127.0.0.1:6000> cluster getkeysinslot 3979 2 len memory sum
1) "mylist1"
2) "4"
3) "165"
4) "mylist2806"
5) "3"
6) "156"
7) "2"
8) "7"
9) "321"

Enterprise 버전에서 count는 필수 입력이 아닙니다.

이 확장 기능은 Enterprise 버전에서 사용 가능합니다.

내부구조

슬롯별 키 저장은 rax(radix tree)구조를 사용한다. 키 앞에 2바이트를 추가해서 slot num를 넣어서 각 슬롯별로 키를 구분하는 역할을 한다.

추가/삭제

typedef struct clusterState {
    rax *slots_to_keys;
}  
void slotToKeyUpdateKey(robj *key, int add) {
    unsigned int hashslot = keyHashSlot(key->ptr,sdslen(key->ptr));
    unsigned char buf[64];
    unsigned char *indexed = buf;
    size_t keylen = sdslen(key->ptr);

    server.cluster->slots_keys_count[hashslot] += add ? 1 : -1;
    if (keylen+2 > 64) indexed = zmalloc(keylen+2);
    indexed[0] = (hashslot >> 8) & 0xff;
    indexed[1] = hashslot & 0xff;
    memcpy(indexed+2,key->ptr,keylen);
    if (add) {
        raxInsert(server.cluster->slots_to_keys,indexed,keylen+2,NULL,NULL);
    } else {
        raxRemove(server.cluster->slots_to_keys,indexed,keylen+2,NULL);
    }
    if (indexed != buf) zfree(indexed);
}

조회

unsigned int getKeysInSlot(unsigned int hashslot, robj **keys, unsigned int count) {
    raxIterator iter;
    int j = 0;
    unsigned char indexed[2];

    indexed[0] = (hashslot >> 8) & 0xff;
    indexed[1] = hashslot & 0xff;
    raxStart(&iter,server.cluster->slots_to_keys);
    raxSeek(&iter,">=",indexed,2);
    while(count-- && raxNext(&iter)) {
        if (iter.key[0] != indexed[0] || iter.key[1] != indexed[1]) break;
        keys[j++] = createStringObject((char*)iter.key+2,iter.key_len-2);
    }
    raxStop(&iter);
    return j;
}

명령문

CLUSTER GETKEYSINSLOT slot count | [count] [type] [len] [memory] [sort|asc|desc] [sum]

이 명령은 version 3.0.0 부터 사용할 수 있다.
논리적 처리 소요시간은 O(N)이다.

Clients for Java	Jedis, Lettuce
Clients for C	Hiredis

<< CLUSTER COUNTKEYSINSLOT	CLUSTER GETKEYSINSLOT	CLUSTER SETSLOT >>

Email 답글이 올라오면 이메일로 알려드리겠습니다.