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에 저장된 값을 확인합니다.
예상 결과:
| key | value |
|---|---|
| session:1001 | user01 |
결과 해석: value가 비어 있으면 키가 없거나 만료된 것입니다.