레디스 클라이언트

다운로드 1
업데이트 2026. 11. 18.

redis-get

Redis 접속 프로파일에서 지정한 키의 값을 조회합니다.

문법

redis-get profile=STRING key=STRING

옵션

profile=STRING
필수 옵션. Redis 접속 프로파일 이름. Redis 클라이언트 (Standalone) 또는 Redis 클라이언트 (Sentinel) 타입의 프로파일을 지정합니다. 예: profile=my_redis
key=STRING
필수 옵션. GET할 Redis 키. 예: key=session:1001

출력 필드

필드타입이름설명
key문자열키Redis 키
value문자열값GET 응답 값. 키가 없으면 null
_error문자열에러명령 실패에 대한 에러 메시지. 성공 시 없음

오류 코드

파싱 오류

오류 메시지원인해결
사용 가능한 Redis 프로파일이 없습니다.profile 옵션에 지정한 이름의 프로파일이 없거나 현재 계정에 사용 권한이 없습니다.프로파일 이름을 확인하고 해당 프로파일의 사용 권한을 부여합니다.
profile 옵션을 지정해야 합니다.profile 옵션이 없거나 비어 있습니다.profile=프로파일명 을 지정합니다.
key 옵션을 지정해야 합니다.key 옵션이 없거나 비어 있습니다.key=키 를 지정합니다.

런타임 오류

오류 메시지원인해결
(출력 행의 _error 필드)Redis 접속 실패, 인증 실패, 타임아웃, WRONGTYPE 등 명령 실행 오류가 발생했습니다. 쿼리는 중단되지 않고 key와 _error만 담긴 한 행이 출력됩니다._error 필드의 메시지를 확인하고 접속 정보와 키 타입을 점검합니다.

설명

접속 프로파일의 Redis 서버에 접속해 GET 명령을 실행하고 결과를 한 행으로 출력합니다. 파이프 입력을 받지 않는 시작 명령이므로 쿼리의 맨 앞에 사용합니다.

키가 존재하지 않으면 value가 null인 행이 출력됩니다. 문자열이 아닌 타입의 키에 사용하면 WRONGTYPE 오류가 _error 필드로 출력됩니다. 접속은 명령 실행마다 새로 맺고 종료 시 닫습니다.

사용 예

예시: 세션 키 값 조회

상황: 세션 키 session:1001에 저장된 값을 확인합니다.

redis-get profile=my_redis key=session:1001

예상 결과:

keyvalue
session:1001user01

결과 해석: value가 비어 있으면 키가 없거나 만료된 것입니다.