1편. Redis 설치 및 기본 명령어 정리

반응형

 

1편. Redis 설치 및 기본 명령어 정리

 

📚 목차
1. Redis와 실습 환경 이해하기
2. Docker로 Redis 설치 및 실행하기
3. Redis 기본 설정 이해하기
4. redis-cli와 기본 명령어 정리

 

📂 [GitHub 코드 보러가기] : https://github.com/cericube/nodejs-practice-lab/tree/main/redis-examples

 

1. Redis와 실습 환경 이해하기

🔷 Redis 란

2026.05.26 - [5. IT기술노트/인프라&개발] - Redis의 기술적 특징과 고성능 데이터 처리 구조

Redis는 메모리에 데이터를 저장하는 key-value 기반 데이터 저장소입니다.
일반적인 관계형 데이터베이스처럼 영구 데이터를 중심으로 다루기보다는, 빠르게 읽고 써야 하는 데이터를 처리할 때 자주 사용합니다.

대표적으로 다음과 같은 상황에서 많이 사용됩니다.

- 캐시
- 세션 저장
- 인증 코드 저장
- 조회수 카운터
- Rate Limiting
- 좋아요 사용자 목록
- 인기 게시글 랭킹
- 최근 본 게시글 목록
- 비동기 이벤트 큐
- 실시간 알림

Redis는 모든 데이터를 key 기준으로 저장합니다.
그리고 value에는 단순 문자열뿐만 아니라 Hash, List, Set, Sorted Set, Stream 같은 다양한 자료구조를 사용할 수 있습니다.

 

🔷 실습 환경

실습 환경은 다음과 같습니다.

- Windows
- WSL 2 또는 Linux 환경
- Docker
- Docker Compose
- Redis 8.x

Redis는 직접 OS에 설치할 수도 있지만, 실습에서는 Docker를 사용하는 것이 편합니다.
Docker를 사용하면 Redis 서버를 쉽게 생성, 중지, 삭제할 수 있고, 여러 실습 환경을 반복해서 구성하기도 쉽습니다

 

2. Docker로 Redis 설치 및 실행하기

🔷 WSL 및 Docker 설치

Redis를 설치하는 방식은 크게 네 가지 정도로 나눌 수 있으나 이 글 에서는 Docker 방식을 살펴보겠습니다.

2025.03.25 - [1.시스템&인프라/가상화(WSL,VirtualBox,Docker)] - Windows에서 WSL 2 설치 및 명령어 정리

2025.03.26 - [1.시스템&인프라/가상화(WSL,VirtualBox,Docker)] - WSL 2에 Ubuntu 설치하고 Export/Import로 복제하기

2025.03.27 - [1.시스템&인프라/가상화(WSL,VirtualBox,Docker)] - [Docker]2.Ubuntu에 Docker 설치

2025.03.27 - [1.시스템&인프라/가상화(WSL,VirtualBox,Docker)] - [Docker]4.Docker 명령어 정리(예제 + 설명)

 

🔷 Redis 설치

Redis를 설치하는 방식은 크게 네 가지 정도로 나눌 수 있으나 이 글 에서는 Docker 방식을 살펴보겠습니다.

# redis 8.6 버전을 실행합니다.
# 만역 설치가 안되어 있으면 자동으로 설치합니다.
sudo docker run -d --name redis -p6379:6379 redis:8.6

# 컨테이너가 실행중인지 확인
sudo docker ps

# Redis CLI 접속
sudo docker exec -it redis redis-cli

# redis 종료
sudo docker stop redis

redis 설치 및 실행 테스트

접속 후 PING 명령어를 실행합니다.

PONG이 출력되면 Redis 서버가 정상적으로 동작하는 것입니다.

 

🔷 docker-compose.yml로 Redis 구성하기

Docker 는 컨테이너를 만들고 실행하는 기본 도구이고,
Docker Compose 는 여러 컨테이너를 하나의 애플리케이션처럼 묶어서 실행·관리하는 도구입니다.

services:
  redis:
    image: redis:8.6
    container_name: local-redis
    ports:
      - "6379:6379"
    volumes:
# redis_data:/data는 Docker 볼륨을 Redis 컨테이너의 /data 디렉터리에 연결한다는 뜻입니다.
      - redis_data:/data
    command: redis-server --appendonly yes

volumes:
  redis_data:

위 설정은 Redis를 local-redis라는 이름의 컨테이너로 실행합니다.
redis_data:/data는 Docker 볼륨을 Redis 컨테이너의 /data 디렉터리에 연결하는 설정입니다.
Redis는 기본적으로 메모리에 데이터를 저장하지만, RDB 또는 AOF persistence를 사용하면 데이터를 디스크에도 저장할 수 있습니다.

 

🔷 Docker Compose 실행 및 확인

# 실행
sudo docker compose up -d

# 상태 확인
sudo docker compose ps

# Redis CLI 접속
sudo docker exec -it local-redis redis-cli

# 볼륨 확인
sudo docker volume ls

# Docker named volume이 실제로 어디에 저장되는지 확인
sudo docker volume inspect workspace_redis_data
ex) "Mountpoint": "/var/lib/docker/volumes/workspace_redis_data/_data",

# 종료
 sudo docker compose down

반응형

 

3. Redis 기본 설정 이해하기

🔷 redis.conf 주요 설정

Redis 설정은 보통 redis.conf 파일에서 관리합니다.
대표적인 설정은 다음과 같습니다.

bind 127.0.0.1
port 6379
requirepass your_password
maxmemory 256mb
maxmemory-policy allkeys-lru
appendonly yes

 

설정	의미
bind	Redis가 바인딩할 네트워크 인터페이스
port	Redis 서버 포트
requirepass	Redis 접속 비밀번호
maxmemory	Redis가 사용할 최대 메모리
maxmemory-policy	메모리 초과 시 key 제거 정책
appendonly	AOF persistence 사용 여부

 

 

🔷 비밀번호 설정과 접속 방법

Redis에 비밀번호를 설정하려면 requirepass 옵션을 사용합니다.

requirepass mypassword

 

Docker Compose에서 직접 설정하려면 다음처럼 command 옵션에 추가할 수 있습니다.

services:
  redis:
    image: redis:8.6
    container_name: local-redis
    ports:
      - "6379:6379"
    command: redis-server --requirepass mypassword --appendonly yes

 

비밀번호가 설정된 Redis에 접속하면 바로 명령어를 사용할 수 없습니다.

> docker exec -it local-redis redis-cli
127.0.0.1:6379> PING
(error) NOAUTH Authentication required.

# 이 경우 AUTH 명령어로 인증합니다.
127.0.0.1:6379> AUTH mypassword
OK
127.0.0.1:6379> PING
PONG

처음부터 비밀번호를 함께 전달할 수도 있습니다.

docker exec -it local-redis redis-cli -a mypassword

 

 

🔷 maxmemory와 Eviction Policy

Redis가 사용할 수 있는 메모리 한도를 설정할 수 있습니다.

maxmemory 256mb

 

Redis가 maxmemory에 도달했을 때 어떤 데이터를 제거할지 결정하는 정책을 Eviction Policy라고 합니다.

LRU(Least Recently Used) 최근에 덜 사용된 데이터를 제거

maxmemory-policy allkeys-lru

정책	설명
noeviction	메모리가 가득 차면 쓰기 요청에 에러 반환
allkeys-lru	전체 key 중 LRU( 기준으로 제거
volatile-lru	expire가 설정된 key 중 LRU 기준으로 제거
allkeys-random	전체 key 중 랜덤 제거
volatile-random	expire가 설정된 key 중 랜덤 제거
volatile-ttl	expire가 설정된 key 중 TTL이 짧은 key 우선 제거

캐시 서버로 Redis를 사용할 때는 allkeys-lru 계열을 자주 고려합니다.
반대로 중요한 임시 데이터나 큐 데이터를 저장하는 Redis라면, key가 임의로 제거되는 정책이 위험할 수 있습니다.

 

🔷 RDB와 AOF Persistence

Redis는 기본적으로 메모리에 데이터를 저장하지만, 설정에 따라 디스크에도 데이터를 저장할 수 있습니다. 이를 Persistence라고 합니다

Redis의 대표적인 persistence 방식은 RDB와 AOF입니다.

구분	RDB	AOF
저장 방식	특정 시점의 데이터를 스냅샷 파일로 저장	Redis에 들어온 쓰기 명령을 로그 형태로 계속 기록
저장 단위	데이터 전체 상태	실행된 쓰기 명령
대표 설정	save 900 1 save 300 10 save 60 10000	appendonly yes appendfsync everysec
장점	파일 크기가 비교적 작음 복구 속도가 빠른 편 백업 파일로 관리하기 좋음	데이터 유실 가능성이 상대적으로 낮음 쓰기 명령 기반으로 복구 가능 운영 환경에서 안정성 확보에 유리
단점	마지막 스냅샷 이후 데이터는 유실될 수 있음	RDB보다 파일 크기가 커질 수 있음 fsync 정책에 따라 성능 영향이 있을 수 있음
적합한 경우	캐시처럼 일부 데이터 유실이 허용되는 경우 빠른 백업과 복구가 중요한 경우	세션, 큐, 중요한 임시 데이터처럼 유실을 줄여야 하는 경우
개발 환경 추천	기본 설정으로도 충분히 실습 가능	데이터 유지 실습을 위해 appendonly yes 설정 추천
운영 환경 고려사항	스냅샷 주기와 데이터 유실 허용 범위를 검토해야 함	appendfsync everysec를 많이 사용하며 성능과 안정성 균형을 고려해야 함

 

RDB 설정 예시는 다음과 같습니다.

설정	의미
save 900 1	900초 동안 1개 이상 변경되면 스냅샷 저장
save 300 10	300초 동안 10개 이상 변경되면 스냅샷 저장
save 60 10000	60초 동안 10000개 이상 변경되면 스냅샷 저장

 

AOF의 appendfsync 옵션은 다음과 같습니다.

옵션	설명	특징
always	매 쓰기 명령마다 디스크에 동기화	데이터 안정성은 가장 높지만 성능 저하 가능성이 큼
everysec	1초마다 디스크에 동기화	성능과 안정성의 균형이 좋아 일반적으로 많이 사용
no	OS가 디스크 동기화 시점을 결정	성능은 좋지만 장애 발생 시 데이터 유실 가능성이 큼

개발 실습에서는 appendonly yes 정도만 설정해도 충분합니다.

 

🔷 redis.conf를 Docker에 적용하는 방법

Docker에서 Redis 설정을 바꾸는 대표적인 방법은 세 가지입니다.

1. redis-server 실행 옵션으로 설정 전달
2. 호스트의 redis.conf 파일을 컨테이너에 마운트
3. docker-compose.yml에서 redis.conf를 마운트

 

✔️ 방법 1: docker run에서 설정 옵션 직접 전달

간단한 테스트라면 redis-server 실행 옵션으로 설정을 넘길 수 있습니다.

# 메모리 제한과 eviction policy 설정 예시
docker run -d \
  --name redis \
  -p 6379:6379 \
  redis:8.6 \
  redis-server \
  --maxmemory 256mb \
  --maxmemory-policy allkeys-lru

 

✔️ 방법 2: 호스트의 redis.conf를 Docker 컨테이너에 마운트

# 프로젝트 구조 예시
my-project/
├── docker-compose.yml
└── redis/
    └── redis.conf

 

redis/redis.conf

bind 0.0.0.0
port 6379

requirepass mypassword

maxmemory 256mb
maxmemory-policy allkeys-lru

appendonly yes
appendfsync everysec
dir /data

 

docker 실행

sudo docker run -d \
  --name redis-conf \
  -p 6379:6379 \
  -v /mnt/d/NodejsDevelope/workspace/redis/redis.conf:/usr/local/etc/redis/redis.conf \
  -v redis_data:/data \
  redis:8.6 \
  redis-server /usr/local/etc/redis/redis.conf

 

✔️ 방법 3: docker-compose.yml에서 redis.conf 마운트

# 프로젝트 구조
my-project/
├── docker-compose.yml
└── redis/
    └── redis.conf

 

redis/redis.conf

bind 0.0.0.0
port 6379

requirepass mypassword

maxmemory 256mb
maxmemory-policy allkeys-lru

appendonly yes
appendfsync everysec
dir /data

 

docker-compose.yml

services:
  redis:
    image: redis:8.6
    container_name: local-redis
    ports:
      - "6379:6379"
    volumes:
      - ./redis/redis.conf:/usr/local/etc/redis/redis.conf
      - redis_data:/data
    command: redis-server /usr/local/etc/redis/redis.conf
    restart: unless-stopped

volumes:
  redis_data:

 

실행

# 실행
docker compose up -d

# 로그 확인
docker compose logs -f redis

# redis-cli 접속
docker exec -it local-redis redis-cli -a mypassword

# 테스트
PING

 

4. redis-cli와 기본 명령어 정리

🔷 redis-cli 접속 명령어

redis-cli는 Redis 서버에 명령어를 직접 입력할 수 있는 터미널 도구입니다.

명령어	설명
redis-cli	로컬 Redis에 기본 접속
redis-cli -h 127.0.0.1 -p 6379	호스트와 포트를 지정해서 접속
redis-cli -a mypassword	비밀번호가 설정된 Redis에 접속
AUTH mypassword	CLI 접속 후 비밀번호 인증
docker exec -it local-redis redis-cli	Docker 컨테이너 내부에서 Redis CLI 실행
docker compose exec redis redis-cli	Docker Compose 서비스 내부에서 Redis CLI 실행
PING	Redis 서버 응답 확인

docker exec -it local-redis redis-cli

# 비밀번호가 있는 경우
docker exec -it local-redis redis-cli -a mypassword

 

🔷 서버 상태 확인 명령어

명령어	설명
PING	Redis 서버와 정상 통신 가능한지 확인
INFO	Redis 서버 전체 상태 정보 출력
INFO server	Redis 버전, OS, 프로세스 정보 확인
INFO memory	Redis 메모리 사용량 확인
INFO clients	현재 연결된 클라이언트 정보 확인
INFO stats	명령어 처리량, hit/miss 등 통계 확인
INFO persistence	RDB, AOF 저장 상태 확인
DBSIZE	현재 DB에 저장된 key 개수 확인
TIME	Redis 서버의 현재 시간 확인
CLIENT LIST	현재 Redis에 연결된 클라이언트 목록 확인
CONFIG GET <pattern>	Redis 설정값 조회

127.0.0.1:6379> INFO memory
127.0.0.1:6379> DBSIZE
(integer) 0
127.0.0.1:6379> CONFIG GET maxmemory

 

🔷 Key 관리 명령어

Redis의 모든 데이터는 key를 기준으로 저장됩니다.
따라서 Redis를 사용할 때는 key 조회, 삭제, TTL 설정, 타입 확인 명령어에 익숙해야 합니다.

실무에서는 key 이름을 다음처럼 계층적으로 설계하는 경우가 많습니다.

# 일반적인 계층 구조 규칙
용도:도메인:식별자:속성

# 예시
cache:user:1
string:auth-code:kim@example.com
hash:user-profile:1
list:user:1:recent-posts
set:post-likes:100
zset:post-ranking
stream:orders

명령어	설명
EXISTS key	key가 존재하는지 확인
TYPE key	key에 저장된 데이터 타입 확인
DEL key	key 삭제
UNLINK key	key를 비동기 방식으로 삭제
EXPIRE key seconds	key에 만료 시간 설정
TTL key	key의 남은 만료 시간 확인
PERSIST key	key의 만료 시간 제거
RENAME oldKey newKey	key 이름 변경
KEYS pattern	패턴에 맞는 key 목록 조회
SCAN cursor	key를 cursor 방식으로 점진적 조회

127.0.0.1:6379> SET user:1:name "Kim"
OK

127.0.0.1:6379> EXISTS user:1:name
(integer) 1

127.0.0.1:6379> GET user:1:name
"Kim"

127.0.0.1:6379> TYPE user:1:name
string

127.0.0.1:6379> EXPIRE user:1:name 60
(integer) 1

127.0.0.1:6379> TTL user:1:name
(integer) 52

127.0.0.1:6379> PERSIST user:1:name
(integer) 1

127.0.0.1:6379> TTL user:1:name
(integer) -1

127.0.0.1:6379> UNLINK user:1:name
(integer) 1

운영 환경에서는 KEYS * 명령어를 주의해야 합니다.
KEYS는 전체 key를 한 번에 조회하므로 key가 많은 Redis에서는 성능에 영향을 줄 수 있습니다.

운영 환경에서는 SCAN을 사용하는 것이 좋습니다.

127.0.0.1:6379> SCAN 0

 

🔷 String 기본 명령어

String은 Redis에서 가장 기본적인 자료구조입니다.
이름은 String이지만 단순 문자열뿐만 아니라 숫자, JSON 문자열, 토큰, 인증 코드, 카운터 값 등을 저장할 때 자주 사용합니다.

- 사용자 조회 결과 캐시
- 이메일 인증 코드
- Access Token 또는 Refresh Token
- 게시글 조회수 카운터
- 로그인 실패 횟수
- Rate Limiting
- 분산 락의 기본 구조

명령어	설명
SET key value	문자열 값 저장
GET key	문자열 값 조회
SET key value EX seconds	값을 저장하면서 TTL 설정
SET key value NX	key가 없을 때만 저장
SET key value XX	key가 이미 있을 때만 저장
MSET key value key value	여러 key-value를 한 번에 저장
MGET key key	여러 key 값을 한 번에 조회
INCR key	숫자 값을 1 증가
DECR key	숫자 값을 1 감소
INCRBY key number	숫자 값을 지정한 수만큼 증가
DECRBY key number	숫자 값을 지정한 수만큼 감소

127.0.0.1:6379> SET greeting "Hello Redis"
OK

127.0.0.1:6379> GET greeting
"Hello Redis"

127.0.0.1:6379> SET auth-code:kim@example.com "123456" EX 180
OK

127.0.0.1:6379> TTL auth-code:kim@example.com
(integer) 175

127.0.0.1:6379> INCR post:1:view-count
(integer) 1

127.0.0.1:6379> INCR post:1:view-count
(integer) 2

 

🔷 Hash 기본 명령어

Hash는 하나의 Redis key 안에 여러 field-value를 저장하는 자료구조입니다.
JavaScript 객체나 JSON 객체와 비슷하게 생각할 수 있습니다.

- 사용자 프로필
- 세션 정보
- 상품 재고 상태
- 사용자 설정
- 카운터가 포함된 객체 데이터

예를 들어 사용자 프로필은 다음과 같이 표현할 수 있습니다.

key: hash:user-profile:1

field: id      value: 1
field: name    value: Kim
field: email   value: kim@example.com
field: status  value: ACTIVE

명령어	설명
HSET key field value	Hash에 field-value 저장
HGET key field	특정 field 값 조회
HGETALL key	모든 field-value 조회
HMGET key field field	여러 field 값 조회
HDEL key field	특정 field 삭제
HEXISTS key field	특정 field 존재 여부 확인
HINCRBY key field number	특정 field의 숫자 값 증가
HKEYS key	field 목록 조회
HVALS key	value 목록 조회
HLEN key	field 개수 조회

127.0.0.1:6379> HSET hash:user-profile:1 id 1 name "Kim" email "kim@example.com" status "ACTIVE"
(integer) 4

127.0.0.1:6379> HGET hash:user-profile:1 name
"Kim"

127.0.0.1:6379> HGETALL hash:user-profile:1
1) "id"
2) "1"
3) "name"
4) "Kim"
5) "email"
6) "kim@example.com"
7) "status"
8) "ACTIVE"

 

🔷 List 기본 명령어

List는 순서가 있는 문자열 목록입니다.
Redis List는 왼쪽과 오른쪽 양쪽에서 데이터를 넣고 뺄 수 있습니다.

왼쪽  <---- List ---->  오른쪽
LPUSH                   RPUSH
LPOP                    RPOP

- 최근 본 게시글 목록
- 최근 검색어 목록
- 간단한 작업 큐
- 최근 로그 버퍼

중요한 작업 큐를 안정적으로 운영해야 한다면 단순 List보다 Redis Stream이나 BullMQ 같은 도구를 고려하는 것이 좋습니다.

명령어	설명
LPUSH key value	리스트 왼쪽에 값 추가
RPUSH key value	리스트 오른쪽에 값 추가
LPOP key	리스트 왼쪽 값을 꺼내고 제거
RPOP key	리스트 오른쪽 값을 꺼내고 제거
LRANGE key start stop	리스트의 지정 범위 조회
LLEN key	리스트 길이 조회
LINDEX key index	특정 인덱스 값 조회
LTRIM key start stop	지정 범위만 남기고 나머지 제거
BLPOP key timeout	값이 들어올 때까지 기다렸다가 왼쪽에서 꺼냄
BRPOP key timeout	값이 들어올 때까지 기다렸다가 오른쪽에서 꺼냄

127.0.0.1:6379> LPUSH list:user:1:recent-posts 101
(integer) 1

127.0.0.1:6379> LPUSH list:user:1:recent-posts 102
(integer) 2

127.0.0.1:6379> LPUSH list:user:1:recent-posts 103
(integer) 3

127.0.0.1:6379> LRANGE list:user:1:recent-posts 0 -1
1) "103"
2) "102"
3) "101"

127.0.0.1:6379> LTRIM list:user:1:recent-posts 0 9
OK

 

🔷 Set 기본 명령어

Set은 중복을 허용하지 않는 집합입니다.
같은 값을 여러 번 넣어도 한 번만 저장됩니다.

- 게시글 좋아요 사용자 목록
- 일일 방문자 중복 제거
- 온라인 사용자 관리
- 중복 요청 방지
- 사용자 관심 태그
- 권한 목록

명령어	설명
SADD key member	Set에 member 추가
SREM key member	Set에서 member 제거
SMEMBERS key	Set의 모든 member 조회
SISMEMBER key member	특정 member 존재 여부 확인
SCARD key	Set에 저장된 member 개수 조회
SRANDMEMBER key count	랜덤 member 조회
SPOP key	랜덤 member를 꺼내고 제거
SINTER key key	교집합
SUNION key key	합집합
SDIFF key key	차집합
SSCAN key cursor	큰 Set을 cursor 방식으로 조회

127.0.0.1:6379> SADD set:post-likes:100 1
(integer) 1

127.0.0.1:6379> SADD set:post-likes:100 2
(integer) 1

127.0.0.1:6379> SADD set:post-likes:100 1
(integer) 0

127.0.0.1:6379> SISMEMBER set:post-likes:100 1
(integer) 1

127.0.0.1:6379> SCARD set:post-likes:100
(integer) 2

 

🔷 Sorted Set 기본 명령어

Sorted Set은 Set에 score가 추가된 자료구조입니다.
member는 중복되지 않고, 각 member는 score를 가집니다.
Redis는 이 score를 기준으로 데이터를 정렬합니다.

- 인기 게시글 랭킹
- 검색어 순위
- 사용자 포인트 랭킹
- 게임 랭킹
- 우선순위 큐

명령어	설명
ZADD key score member	Sorted Set에 score와 member 저장
ZINCRBY key increment member	member의 score 증가
ZRANGE key start stop	score가 낮은 순서로 조회
ZREVRANGE key start stop	score가 높은 순서로 조회
ZRANGE key start stop WITHSCORES	score와 함께 낮은 순서로 조회
ZREVRANGE key start stop WITHSCORES	score와 함께 높은 순서로 조회
ZRANK key member	낮은 score 기준 순위 조회
ZREVRANK key member	높은 score 기준 순위 조회
ZSCORE key member	특정 member의 score 조회
ZCARD key	member 개수 조회
ZREM key member	특정 member 제거

127.0.0.1:6379> ZADD zset:post-ranking 10 101
(integer) 1

127.0.0.1:6379> ZADD zset:post-ranking 20 102
(integer) 1

127.0.0.1:6379> ZINCRBY zset:post-ranking 5 101
"15"

127.0.0.1:6379> ZREVRANGE zset:post-ranking 0 2 WITHSCORES
1) "102"
2) "20"
3) "101"
4) "15"

 

🔷 Stream 기본 명령어

Redis Stream은 메시지를 저장할 수 있는 로그형 자료구조입니다.
Pub/Sub과 달리 메시지가 Redis에 남습니다.
또한 Consumer Group을 사용하면 여러 worker가 메시지를 나누어 처리할 수 있습니다.

Producer -> Stream -> Consumer Group -> Consumer

- 주문 이벤트 저장
- 알림 이벤트 큐
- 이메일 작업 큐
- 감사 로그
- 비동기 작업 처리

명령어	설명
XADD key * field value	Stream에 메시지 추가
XRANGE key start end	오래된 순서로 메시지 조회
XREVRANGE key end start	최신 순서로 메시지 조회
XLEN key	Stream 메시지 개수 조회
XREAD STREAMS key id	Stream에서 메시지 읽기
XGROUP CREATE key group id	Consumer Group 생성
XREADGROUP GROUP group consumer STREAMS key id	Consumer Group 기준 메시지 읽기
XACK key group id	메시지 처리 완료 처리
XPENDING key group	읽었지만 ACK되지 않은 메시지 확인
XDEL key id	특정 메시지 삭제

127.0.0.1:6379> XADD stream:orders * orderId 1 userId 10 status CREATED
"1780000000000-0"

127.0.0.1:6379> XADD stream:orders * orderId 2 userId 11 status CREATED
"1780000001000-0"

127.0.0.1:6379> XRANGE stream:orders - +
1) 1) "1780000000000-0"
   2) 1) "orderId"
      2) "1"
      3) "userId"
      4) "10"
      5) "status"
      6) "CREATED"
2) 1) "1780000001000-0"
   2) 1) "orderId"
      2) "2"
      3) "userId"
      4) "11"
      5) "status"
      6) "CREATED"

 

 

🔷Pub/Sub 기본 명령어

Pub/Sub은 메시지를 발행하고 구독하는 기능입니다.
하나의 클라이언트가 특정 채널을 구독하고 있으면, 다른 클라이언트가 해당 채널로 메시지를 발행할 수 있습니다.

Publisher -> Redis Channel -> Subscriber

- 실시간 알림
- 캐시 무효화
- 채팅 브로드캐스트
- 관리자 공지
- 서버 간 간단한 이벤트 전달

Pub/Sub은 메시지를 저장하지 않습니다.

 

즉, 구독자가 없는 동안 발행된 메시지는 나중에 받을 수 없습니다.
메시지를 저장하고, 처리 상태를 관리하고, 실패한 메시지를 재처리해야 한다면 Pub/Sub보다 Redis Stream을 사용하는 것이 더 적합합니다.

명령어	설명
SUBSCRIBE channel	특정 채널 구독
PSUBSCRIBE pattern	패턴에 맞는 여러 채널 구독
PUBLISH channel message	특정 채널에 메시지 발행
UNSUBSCRIBE channel	채널 구독 해제
PUNSUBSCRIBE pattern	패턴 구독 해제
PUBSUB CHANNELS	현재 활성화된 Pub/Sub 채널 목록 조회
PUBSUB NUMSUB channel	특정 채널의 구독자 수 조회

# 첫 번째 터미널에서 구독합니다.
docker exec -it local-redis redis-cli

# 두 번째 터미널에서 메시지를 발행합니다.
docker exec -it local-redis redis-cli
127.0.0.1:6379> PUBLISH channel:notification "new notification"
(integer) 1


# 첫 번째 터미널에서는 다음과 같이 메시지를 받을 수 있습니다.
1) "message"
2) "channel:notification"
3) "new notification"

 

---

※ 게시된 글 및 이미지 중 일부는 AI 도구의 도움을 받아 생성되거나 다듬어졌습니다.

반응형