Redis - Get Started

✅ Redis란?(Remote Dictionary Service)

속도가 어어어어ㅓㅁ청 빠른 데이터베이스.

대부분의 경우 다른 SQL 데이터베이스와 같이 사용하게 된다.

Redis는 Key Value In-memory 데이터베이스다.

(SQL, MongoDB 등은 디스크에서 값을 읽어오느라 상대적으로 느리다.)

장점: 빠르다.

단점: 비싸다.

용량이 하드 디스크처럼 충분하지가 않기에, 다른 데이터베이스들을 보조하는 용도로 사용한다.

✅ 설치

brew install redis

brew services start redis

✅ Usecase

다음 명령어를 입력해서 cli를 활성화한다.

redis-cli

GET, SET

╰─ redis-cli                                                                                                                          ─╯
127.0.0.1:6379> SET hello world
OK
127.0.0.1:6379> GET hello
"world"
127.0.0.1:6379> SET hello bye
OK
127.0.0.1:6379> GET hello
"bye"
127.0.0.1:6379>

Redis의 SET은 언제나 덮어쓴다.
명령어는 대소문자 상관없지만 데이터와 구분하기 위하여 대문자로 입력하는 것을 추천.
string을 저장할 때 world나 "world"나 똑같다.

Convention

127.0.0.1:6379> SET users:1 nico
OK
127.0.0.1:6379> GET users:1
"nico"
127.0.0.1:6379>

users:1 이런 식으로 users 뒤에 userID를 붙이는 게 관습이다.(공식문서도 이 방식으로 함)

DEL

127.0.0.1:6379> DEL users:1 hello
(integer) 2
127.0.0.1:6379>

지정해서 삭제

FLUSHALL

127.0.0.1:6379> FLUSHALL
OK
127.0.0.1:6379>

메모리 전체 삭제

Key 만료 시점 지정 가능

127.0.0.1:6379> SET users:1 nico NX EX 10
OK

NX: users:1 가 없을 때 nico 값을 저장해라.
XX: users:1 가 있을 때 nico 값을 저장해라.

EX seconds: 만료시간 지정

MGET, MSET

127.0.0.1:6379> MSET users:1 nico users:2 lynn users:3 lanna
OK
127.0.0.1:6379> MGET users:1 users:2 users:3
1) "nico"
2) "lynn"
3) "lanna"
127.0.0.1:6379>

Multiple로 GET, SET 할 수 있음

INCR, DECR

127.0.0.1:6379> SET visitors 0
OK
127.0.0.1:6379> INCR visitors
(integer) 1
127.0.0.1:6379> INCR visitors
(integer) 2
127.0.0.1:6379>

INCR를 사용하여 string 데이터 타입을 증가 시킬 수 있다.

127.0.0.1:6379> SET visitors 0
OK
127.0.0.1:6379> INCR visitors
(integer) 1
127.0.0.1:6379> INCR visitors
(integer) 2
127.0.0.1:6379> DECR visitors
(integer) 1
127.0.0.1:6379>

DECR는 반대

INCRBY, DECRBY

127.0.0.1:6379> DECR visitors
(integer) 1
127.0.0.1:6379> INCRBY visitors 10
(integer) 11
127.0.0.1:6379> DECRBY visitors 5
(integer) 6
127.0.0.1:6379>

증가, 감소 단계 지정 가능

LPUSH, RPUSH

127.0.0.1:6379> LPUSH l 1
(integer) 1
127.0.0.1:6379> LPUSH l 2
(integer) 2
127.0.0.1:6379> LPUSH l 3
(integer) 3
127.0.0.1:6379> LPUSH l 4
(integer) 4
127.0.0.1:6379> LPUSH l 5
(integer) 5
127.0.0.1:6379> LRANGE l 0 -1
1) "5"
2) "4"
3) "3"
4) "2"
5) "1"
127.0.0.1:6379>

왼쪽에서 추가됨. 먼저 들어간 값이 오른쪽으로 가게 됨

127.0.0.1:6379> RPUSH l 0
(integer) 6
127.0.0.1:6379> LRANGE l 0 -1
1) "5"
2) "4"
3) "3"
4) "2"
5) "1"
6) "0"
127.0.0.1:6379>

RPUSH는 반대

LPOP, RPOP

127.0.0.1:6379> LRANGE l 0 -1
1) "5"
2) "4"
3) "3"
4) "2"
5) "1"
6) "0"
127.0.0.1:6379> LPOP l
"5"
127.0.0.1:6379> RPOP l
"0"
127.0.0.1:6379>

127.0.0.1:6379> RPOP l 2
1) "1"
2) "2"
127.0.0.1:6379>

여러 개 pop할 수도 있음

LLEN

127.0.0.1:6379> LLEN l
(integer) 2

List length 구하기

LSET

127.0.0.1:6379> LRANGE l 0 -1
1) "4"
2) "3"
127.0.0.1:6379> LSET l 1 hello
OK
127.0.0.1:6379> LRANGE l 0 -1
1) "4"
2) "hello"
127.0.0.1:6379>

index를 사용해서 해당 index의 값을 바꾸기

https://redis.io/docs/latest/commands/?group=list

Commands

Redis Cloud Fully managed and integrated with Google Cloud, Azure, and AWS.

redis.io

Set

List와 비슷하지만 List처럼 정렬되어있지 않고, 중복된 value를 허용하지 않는다.

SADD

127.0.0.1:6379> SADD votes:song:1 user:1
(integer) 1
127.0.0.1:6379> SADD votes:song:1 user:2
(integer) 1
127.0.0.1:6379> SADD votes:song:1 user:2
(integer) 0

중복 허용 x

SMEMBERS

127.0.0.1:6379> SMEMBERS votes:song:1
1) "user:1"
2) "user:2"

해당 key를 가지는 set의 value들을 보여줌

SISMEMBER

127.0.0.1:6379> SISMEMBER votes:song:1 user:1
(integer) 1
127.0.0.1:6379> SISMEMBER votes:song:1 user:3
(integer) 0

user:1이 votes:song:1의 member인지 확인

SCARD

127.0.0.1:6379> SCARD votes:song:1
(integer) 2

Cardinality의 줄임말

Set 원소의 개수를 보여줌

SINTER

127.0.0.1:6379> SINTER votes:song:1 votes:song:2
1) "user:3"

교집합 구하기(intersection)

SDIFF

127.0.0.1:6379> SDIFF votes:song:1 votes:song:2
1) "user:2"
2) "user:1"

votes:song:1에는 있지만 votes:song:2에는 없는 원소들

SUNION

127.0.0.1:6379> SUNION votes:song:1 votes:song:2
1) "user:4"
2) "user:1"
3) "user:2"
4) "user:3"
5) "user:5"

합집합

SREM

127.0.0.1:6379> SREM votes:song:1 user:1
(integer) 1
127.0.0.1:6379> SMEMBERS votes:song:1
1) "user:2"
2) "user:3"

member 삭제

Hash

Key와 Value 쌍의 모음
Redis의 Hash는 중첩된 Hash를 지원하지 않는다.

HSET, HGET, HGETALL

127.0.0.1:6379> HSET player:1 name nico xp 0 health 100
(integer) 3
127.0.0.1:6379> HGET player:1 name
"nico"
127.0.0.1:6379> HGETALL player:1
1) "name"
2) "nico"
3) "xp"
4) "0"
5) "health"
6) "100"

HINCRBY

127.0.0.1:6379> HINCRBY player:1 xp 10
(integer) 10
127.0.0.1:6379> HGETALL player:1
1) "name"
2) "nico"
3) "xp"
4) "10"
5) "health"
6) "100"

127.0.0.1:6379> HINCRBY player:1 health -10
(integer) 90

HMGET

127.0.0.1:6379> HMGET player:1 xp health
1) "10"
2) "90"

Multiple GET

HEXISTS

127.0.0.1:6379> HEXISTS player:1 xp
(integer) 1

Sorted Set

각각의 value에 점수를 부여할 수 있고, 그 점수에 따라 정렬된다.

127.0.0.1:6379> ZADD scores 1 user:1 2 user:2 10 user:3 6 user:4
(integer) 4
127.0.0.1:6379> ZRANGE scores 0 -1
1) "user:1"
2) "user:2"
3) "user:4"
4) "user:3"

WITHSCORES

127.0.0.1:6379> ZRANGE scores 0 -1 WITHSCORES
1) "user:1"
2) "1"
3) "user:2"
4) "2"
5) "user:4"
6) "6"
7) "user:3"
8) "10"

ZREVRANGE

127.0.0.1:6379> ZREVRANGE scores 0 -1
1) "user:3"
2) "user:4"
3) "user:2"
4) "user:1"

ZRANK

127.0.0.1:6379> ZRANK scores user:1
(integer) 0
127.0.0.1:6379> ZRANK scores user:3
(integer) 3

Sorted Set에서 등수가 몇 등인지 볼 수 있다.

ZADD

127.0.0.1:6379> ZADD scores 20 user:1
(integer) 0
127.0.0.1:6379> ZRANGE scores 0 -1 WITHSCORES
1) "user:2"
2) "2"
3) "user:4"
4) "6"
5) "user:3"
6) "10"
7) "user:1"
8) "20"

내부 데이터 수정

ZINCRBY

127.0.0.1:6379> ZINCRBY scores 30 user:2
"32"
127.0.0.1:6379> ZRANGE scores 0 -1 WITHSCORES
1) "user:4"
2) "6"
3) "user:3"
4) "10"
5) "user:1"
6) "20"
7) "user:2"
8) "32"

ZRANGEBYSCORE

127.0.0.1:6379> ZRANGEBYSCORE scores 7 50
1) "user:3"
2) "user:1"
3) "user:2"

점수가 7점 이상 50점 이하인 사용자들로 제한

ZCOUNT

127.0.0.1:6379> ZCOUNT scores 5 10
(integer) 2

5점 이상 10점 이하의 점수들 카운트

ZREM

127.0.0.1:6379> ZREM scores user:2
(integer) 1
127.0.0.1:6379> ZRANGE scores 0 -1
1) "user:4"
2) "user:3"
3) "user:1"
127.0.0.1:6379>

user:2 삭제

✅ Python 환경에서 Redis 사용하기

Redis 설치

(hiredis는 redis의 최적화 버전)

pip install 'redis[hiredis]'

Redis 사용

import redis

r = redis.Redis(host="localhost", port=6379, decode_responses=True)

r.set("hello", "world")

print(r.get("hello"))

r.hset("users:1", mapping={"name": "nico", "age": 19999})

print(r.hgetall("users:1"))

decode_responses는 받은 데이터를 디코딩해서 문자열로 받을지를 설정하는 속성

mapping은 hash 데이터를 작성할 때 console에서처럼 불편하게 작성할 필요없이 구조화 시킬 수 있도록 하는 속성

(python에서 작성한 쿼리 내용을 console에서도 확인 가능하다.)

SQL과 같이 사용

import redis
import sqlite3
import json

r = redis.Redis(host="localhost", port=6379, decode_responses=True)

conn = sqlite3.connect("movies_download.db")
cur = conn.cursor()


def make_expensive_query():
    redis_key = "director:movies"
    cached_results = r.get(redis_key)
    if cached_results:
        print("cache hit")
        return json.loads(cached_results)
    else:
        print("cache miss")
        res = cur.execute("SELECT COUNT(*), director FROM movies GROUP BY director;")
        all_rows = res.fetchall()
        r.set(redis_key, json.dumps(all_rows), ex=20)
        return all_rows


v = make_expensive_query()

conn.commit()
conn.close()
r.close()

✅ TypeScript 환경에서 redis 사용하기

bun add redis

npm install redis

왜 Python은 'redis[hiredis]'를 설치하는가?

Python은 성능을 위해 hiredis 같은 C 확장을 추가로 설치하지만, TypeScript 환경에서는 기본 Redis 클라이언트가 충분히 빠르기 때문에 별도의 옵션 없이 사용한다

Redis Client 연결

import { createClient } from "redis";

const client = createClient();

아무런 옵션 없이 연결하면 기본값으로 localhost와 port:6379에 연결됨(redis-cli로 port 볼 수 있음)

Usage

import { createClient } from "redis";

const client = createClient();

await client.connect();

await client.flushAll();

await client.hSet("users:1", {
  username: "nico",
  password: "1234",
});

const r = await client.hGetAll("users:1");
console.log(r);

await client.close();

Bun을 사용하고 있지 않거나, 사용하고 있는 Node.js 버전에 따라서 위와 같이 모듈 최상위에서 await를 사용하지 못할 수 있다.

(이런 경우엔 모든 await 코드를 async 함수 안에 넣어서 처리해야 한다.)