XRANGE

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

데이터 조회

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

Example

명령>XRANGE sensor-1234 - +
결과>1) 1) 1538319053569-0
    2) 1) "temperature"
        2) "98.7"
2) 1) 1538319053569-1
    2) 1) "temperature"
        2) "98.8"

- +는 해당 키(스트림)의 모든 데이터를 조회합니다.
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와 같거나 큰 데이터가 조회됩니다.

Example

명령>XRANGE sensor-1234 1538319053569-10 + COUNT 1
결과>1538319053569-10

반복 실행

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

Example

명령>XRANGE sensor-1234 1538319053569-11 + COUNT 1
결과>1538319053570-0
명령>XRANGE sensor-1234 1538319053570-1 + COUNT 1
결과>1538319053573-0

명령문

XRANGE key start end [COUNT count] |

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

<< XLEN XRANGE XREVRANGE >>

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