redis commands streams xrange

XRANGE

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

데이터 조회

사용법은 XRANGE key start end입니다.

- +는 해당 키(스트림)의 모든 데이터를 조회합니다.
ID를 지정해서 조회할 수 있고, 이 경우 지정한 ID를 포함해서 조회합니다.

• XRANGE sensor-1234 1538319053569-10 1538319053569-99
• XRANGE sensor-1234 - 1538319053569
• XRANGE sensor-1234 1538319053569 +
• XRANGE sensor-1234 1538319053569 1538319053569

이 경우 ID에 sequenceNumber를 생략할 수 있습니다. sequenceNumber를 생략하면 앞 ID는 0으로 채워지고, 뒤 ID는 18,446,744,073,709,551,615(1천8백경)으로 채워집니다. 이 숫자는 Unsigned 8바이트 정수의 가장 큰 숫자입니다.

• XRANGE sensor-1234 1538319053569-0 1538319053569-18446744073709551615

필드가 여러 개 일 경우 입력된 순서대로 조회됩니다.

ID 미포함 조회(exclusive range)

기본적으로 지정한 ID를 포함해서 조회합니다. 포함하지 않으려면 ID 앞에 '('를 입력하세요.
XRANGE sensor-1234 (1538319053569 (1538319059570
이 기능은 버전 6.2에 추가되었습니다.

COUNT 옵션

조회할 데이터의 개수를 지정하려면 COUNT 옵션을 사용합니다. 이 경우 앞에 지정한 ID와 같거나 큰 데이터가 조회됩니다.

반복 실행

조회된 ID에 1을 더해서 명령을 반복 실행하면 계속 다음 데이터를 조회할 수 있습니다. 이는 다른 데이터 타입의 SCAN 명령과 같은 효과가 있습니다.

명령문

XRANGE key start end [COUNT count] |

• 이 명령은 version 5.0.0 부터 사용할 수 있다.
• 버전 6.2에서 start, end ID를 포함하지 않고 조회하는 '(' 옵션이 추가되었습니다.
• 논리적 처리 소요시간은 O(log(N)+M)이다. N은 스트림에 저장된 엔트리(ID) 개수이고, M은 리턴될 엔트리 개수이다.