redis-cli란 무엇이며 필수 명령어는 무엇인가요?

Question

Accepted Answer

**redis-cli**는 Redis의 명령줄 인터페이스입니다 — Redis 서버에 접속하여 명령어를 대화식으로 실행하는 데 사용됩니다. 개발, 디버깅, 데이터 검사, 관리에 필수적입니다.

## 접속

```bash
redis-cli                          # localhost:6379에 접속 (기본)
redis-cli -h host -p 6379          # 특정 호스트/포트에 접속
redis-cli -a password              # 인증과 함께
redis-cli -n 2                     # 데이터베이스 번호 2 선택
```

## 명령어 실행과 데이터 검사

```bash
# 접속 후 임의의 Redis 명령어 실행
127.0.0.1:6379> SET name "Ann"
127.0.0.1:6379> GET name
127.0.0.1:6379> TYPE name          # 키의 데이터 타입
127.0.0.1:6379> TTL name           # 남은 TTL
127.0.0.1:6379> SCAN 0 MATCH user:*  # 안전하게 키 순회 (운영에서 KEYS 금지)
127.0.0.1:6379> DBSIZE             # DB의 키 개수
```

코드에서 쓰는 것과 같은 Redis 명령어에 더해 데이터를 탐색하는 검사 명령어(`TYPE`, `TTL`, `SCAN`, `DBSIZE`)를 실행합니다.

## 서버 정보와 모니터링

```bash
127.0.0.1:6379> INFO               # 서버 통계 (메모리, 클라이언트, 통계 등)
127.0.0.1:6379> INFO memory        # 메모리 사용 상세
127.0.0.1:6379> MONITOR            # ⚠️ 모든 명령어 실시간 스트림 (디버그 전용 — 부하 추가)
127.0.0.1:6379> SLOWLOG GET        # 최근 느린 명령어 (성능 디버깅)
127.0.0.1:6379> CLIENT LIST        # 접속된 클라이언트
```

`INFO`는 서버 통계(메모리, 클라이언트, 적중률)를 보여줍니다; `MONITOR`는 모든 명령어를 실시간 스트리밍합니다(디버깅에 유용하나 부하 추가 — 주의해서 사용); `SLOWLOG`는 느린 명령어를 찾습니다.

## 유용한 한 줄 명령

```bash
redis-cli PING                     # => PONG (헬스 체크)
redis-cli GET name                 # 단일 명령 실행 후 종료
redis-cli FLUSHDB                  # ⚠️ 현재 DB의 모든 키 삭제 (주의!)
redis-cli --scan --pattern 'user:*' # 패턴에 일치하는 키 스캔
```

## 왜 중요한가

redis-cli는 Redis를 직접 다루는 필수적인 일상 도구이므로, 그 핵심을 아는 것은 Redis를 쓰는 누구에게나 실용적이고 근본적인 지식입니다.

개발자와 관리자는 접속, 명령어 실행, 데이터 검사, 디버깅을 위해 끊임없이 이를 사용합니다 — Redis 서버에 대한 보편적이고 항상 사용 가능한 인터페이스입니다.

접속 방법(로컬/원격 서버, 인증과 데이터베이스 선택), 명령어 실행과 데이터 검사(`GET`/`SET`에 더해 저장된 내용을 탐색하는 `TYPE`, `TTL`, `SCAN`, `DBSIZE`), **서버 정보와 모니터링** 접근(메모리/클라이언트/통계와 특히 **cache 적중률**을 보는 `INFO`, 디버깅 시 실시간 명령 스트림의 `MONITOR`, 느린 명령을 찾는 `SLOWLOG`)을 아는 것은 개발, 디버깅, 관리에 일상적인 실무 지식입니다.

유용한 한 줄 명령(헬스 체크용 `PING`, 단일 명령 실행, 패턴 매칭의 `--scan`)은 redis-cli를 스크립트와 빠른 확인에 편리하게 만듭니다.

중요한 주의사항 — 운영에서 `KEYS`/`MONITOR`를 과도하게 쓰지 않기(부하 추가)와 `FLUSHDB`/`FLUSHALL`의 위험성(모든 데이터 삭제) — 을 아는 것은 안전한 실무 사용을 반영합니다.

redis-cli는 Redis를 직접 다루는(탐색, 디버깅, 모니터링, 관리) 표준적이고 보편적인 방법이고, 필수 명령어를 이해하면 Redis 작업이 효율적이 되므로, redis-cli를 이해하는 것은 가치 있고 자주 적용되는 지식입니다 — Redis를 다루는 누구에게나 기본 역량이며, PostgreSQL의 psql이나 MongoDB의 mongosh를 아는 것과 유사하고, Redis를 검사·디버깅하는 실무적 진입점입니다.