백엔드 개발을 하다 보면 Redis를 자주 접하게 된다.

“캐시”, “세션”, “조회수”, “트래픽 제어” 같은 말과 항상 함께 등장하지만,

막상 Redis가 정확히 뭐고 왜 쓰는지는 애매하게만 알고있었다.

이 글은 Redis를 DB의 대체재가 아니라, DB를 덜 괴롭히기 위한 도구로 이해하는 것을 목표로 한다.

1. Redis 한 문장 정의

Redis는 서버에서 동작하는 메모리 기반 저장소로,짧은 시간 동안 필요한 상태를 초고속으로 처리하기 위해 사용된다.

핵심 키워드는 세 가지다.

서버에서 동작하는 프로그램
메모리(RAM) 기반
단기 저장 / 임시 상태에 특화

2. Redis는 DB가 아니다

가장 먼저 정리해야 할 오해는 이거다.

Redis = 빠른 DB ❌

Redis는 없어도 서비스가 돌아가야 하는 위치에 두는 게 기본 원칙이다.

(Redis 장애 → 성능 저하 / 통계 손실 정도, 서비스 중단 ❌)

3. Redis 서버는 따로 띄워야 한다

Redis는 라이브러리가 아니라 서버 프로그램이다.

로컬 개발에서 가장 흔한 방식 (Docker)

docker run -d \\
  --name local-redis \\
  -p 6379:6379 \\
  redis:7

NestJS에서는 Redis에 “연결”만 한다.

import Redis from 'ioredis';

export const redis = new Redis({
  host: 'localhost',
  port: 6379,
});

5. Redis 명령은 코드에서 실행된다

SET key value EX 60
INCR key

실제로는 TypeScript 코드에서 실행된다.

await redis.set('hello', 'world', 'EX', 60);
await redis.incr('counter');

Redis 명령은 옵션을 문자열 토큰처럼 나열하는 방식이라

함수 인자가 여러 개 들어가는 구조다.

6. Redis의 핵심 자료구조들

6-1. STRING – 가장 기본

await redis.set('post:123:views', '1');
await redis.incr('post:123:views');

단순 카운터
조회수, 플래그, 상태값

6-2. SET – 중복 제거용

await redis.sadd('today:visitors', 'visitorA');

같은 값은 한 번만 들어감
방문자 중복 제거에 적합

6-3. ZSET (Sorted Set) – 정렬된 집합 ⭐️

ZSET은 처음엔 이름부터 헷갈리는데, 이렇게 이해하면 된다.

ZSET = 점수(score)를 기준으로 자동 정렬되는 Map

TypeScript 로 비유해보자면

type ZSet = Record<
  string,               // ZSET key (랭킹판 이름)
  Record<string, number> // member -> score
>;

실제 개념

ZSET key: post:views:2026-02-10

member      score
------------------
post:123     42
post:9       15
post:77       3

7. ZSET 주요 명령어 (TypeScript 예시)

7-1. ZINCRBY – 점수 증가

await redis.zincrby(
  'post:views:2026-02-10', // 랭킹판
  1,                       // 증가량
  'post:123',              // 대상
);

의미:

“오늘 조회수 랭킹에서 post:123의 점수를 1 올려라”

7-2. ZREVRANGE – 상위 랭킹 조회

await redis.zrevrange(
  'post:views:2026-02-10',
  0,
  9,
  'WITHSCORES',
);

→ 오늘 인기글 TOP 10

7-3. ZUNIONSTORE – 여러 ZSET 합치기

await redis.zunionstore(
  'post:views:week',
  3,
  'post:views:2026-02-08',
  'post:views:2026-02-09',
  'post:views:2026-02-10',
);

→ 주간 인기글 랭킹 생성

8. 캐시 예시: DB 조회 결과 저장

async getPost(postId: number) {
  const key = `post:detail:${postId}`;

  const cached = await redis.get(key);
  if (cached) {
    return JSON.parse(cached);
  }

  const post = await this.postRepo.findOne({ where: { id: postId } });

  await redis.set(key, JSON.stringify(post), 'EX', 60);
  return post;
}

캐시는 없어도 되는 데이터
성능 최적화 목적

9. 세션 관리 예시

async login(userId: number) {
  const sessionId = crypto.randomUUID();

  await redis.set(
    `sess:${sessionId}`,
    JSON.stringify({ userId }),
    'EX',
    60 * 60 * 24 * 7,
  );

  return sessionId;
}

async getSession(sessionId: string) {
  const data = await redis.get(`sess:${sessionId}`);
  return data ? JSON.parse(data) : null;
}

Redis = 세션 저장소
서버 여러 대여도 상태 공유 가능

10. 방문자 / 조회수 통계 패턴

“같은 사용자는 하루에 한 번만”

const first = await redis.set(
  `uv:2026-02-10:${visitorId}`,
  '1',
  'NX',
  'EX',
  86400,
);

if (first === 'OK') {
  await redis.incr('uv:2026-02-10');
}

await redis.incr('pv:2026-02-10');

NX → 중복 제거
EX → 하루 지나면 자동 만료

11. Redis는 DB를 대신 업데이트하지 않는다

중요한 포인트다.

Redis는 DB를 모르고,
DB에 언제 반영할지는 서비스가 결정한다.

보통:

요청 시 → Redis에만 기록
스케줄러/배치 → Redis 집계 → DB 저장

12. 언제 Redis를 쓰면 좋은가

조회수 / 좋아요
방문자 중복 제거
랭킹 / TOP N
캐시
세션
Rate Limit

쓰면 안 되는 경우

영구 데이터
결제, 재고 같은 강한 정합성
복잡한 검색/조인

마무리 정리

Redis는 DB 앞에서 트래픽과 중복을 흡수하는 완충 장치다.

Redis를 이해하면

“왜 이걸 쓰는지”가 명확해지고,

그때부터는 필요한 곳에만 정확히 쓰는 설계가 가능해진다

Redis란 무엇이고, 언제 어떻게 써야 할까?

NestJS, TypeScript 개발자 입장에서 Redis 이해해보기