SCAN

레디스 개발자 교육 신청	레디스 정기점검/기술지원 Redis Technical Support	레디스 엔터프라이즈 서버 Redis Enterprise Server

Key들을 일정 단위 개수 만큼씩 조회

사용법은 scan cursor 이다.
KEYS는 한번에 모든 keys를 스켄해서 조회하는 반면, scan은 한번에 약 10개씩 정도 조회한다.
KEYS는 key수가 많을 경우 처리시간이 많이 소요되며, 그 동안 다른 명령을 처리하지 못한다. 그래서 대안으로 나온 것은 SCAN 이다.
key가 많으면 다음 커서를 지정해서 반복해서 조회한다. 모두 조회했을 경우 next cursor가 0 이다.
SSCAN, ZSCAN, HSCAN은 key에 속한 member를 조회하는 반면, SCAN은 DB안에 있는 모든 key를 조회한다.

Example

명령> scan 0

결과> next cursor -> 1024
0) key001
1) key002
2) key005
...
11) key021

명령> scan 1024

결과> next cursor -> 18944
0) key031
1) key022
2) key035
...
9) key151

MATCH key_pattern 옵션 사용

사용법은 scan cursor MATCH pattern 이다.
지정한 key_pattern에 맞는 key들만 조회한다.
GLOB style pattern이다.

Example

명령> scan 0 match key*

결과> next cursor -> 1024
0) key001
1) key002
2) key005
...
11) key021

COUNT count 옵션 사용

사용법은 scan cursor COUNT 10 이다.
조회되는 key수가 지정한 count와 항상 딱 맞지는 않는다. 처리시간을 고려해서 개수를 조절한다.

Example

명령> scan 0 count 10

결과> next cursor -> 1024
0) key001
1) key002
2) key005
...
11) key021

TYPE type 옵션 사용

사용법은 scan cursor TYPE string 이다.
TYPE을 지정하면 해당 type의 키들만 조회한다.

Example

명령> scan 0 type string

결과> next cursor -> 1024
0) key001
1) key002
2) key005
...
11) key021

명령문

SCAN cursor [MATCH pattern] [COUNT count] [TYPE type]

이 명령은 version 2.8.0 부터 사용할 수 있다.
TYPE 옵션은 Redis-6.0.0부터 사용 가능합니다.
논리적 처리 소요시간은 O(N)이다.