시작하기
Redis 서버에 연결
redis-cli는 표준 명령줄 클라이언트입니다. 기본값은 127.0.0.1:6379에 연결합니다. 호스트는 -h, 포트는 -p, 비밀번호는 -a로 지정합니다(또는 REDISCLI_AUTH 환경 변수를 설정해 셸 히스토리에 비밀번호가 남지 않게 하세요). TLS를 쓰려면 --tls와 인증서/키가 필요합니다. Redis 6 이상에서는 redis:// URL 스킴을 지원하고, TLS에는 rediss://를 사용합니다.
# connect to local server (default port 6379)
redis-cli
# connect to a remote host with custom port
redis-cli -h redis.example.com -p 6380
# connect with authentication
redis-cli -a "yourpassword"
redis-cli -h host -p 6379 -a "yourpassword"
# connect over TLS
redis-cli --tls --cert client.crt --key client.key -h host -p 6379
# connect using a URL (Redis 6+)
redis-cli redis://user:password@host:6379/0
redis-cli rediss://user:password@host:6379/0 # TLS연결 옵션과 모드
redis-cli는 대화형 모드와 단발(one-shot) 모드를 모두 지원합니다. 명령을 인자로 넘기면 실행 후 종료합니다. 파이프 모드는 stdin에서 RESP/텍스트 명령을 읽으므로 스크립팅과 대량 적재에 좋습니다. -n은 논리 데이터베이스를 선택합니다. --stat와 --latency는 내장 모니터링 도우미입니다. --raw는 타입 접두사 없이 값을 출력해 파이프 처리에 유용합니다.
# select a specific database index (0-15)
redis-cli -n 1 # use database 1
# run a single command and exit (non-interactive)
redis-cli GET mykey
redis-cli -h host PING
# pass command with arguments
redis-cli SET counter 100
redis-cli INCR counter
# read commands from stdin (pipe mode)
echo "SET k1 v1" | redis-cli
cat commands.txt | redis-cli
# repeat a command every second (watch mode)
redis-cli --stat
redis-cli --latency
# pretty-print JSON output (Redis 6+)
redis-cli --raw GET user:jsonPING과 연결 테스트
PING은 가장 간단한 상태 확인 방법입니다. 정상 동작하는 Redis는 PONG을 반환합니다. --latency는 왕복 시간을 계속 측정하며(네트워크 문제 진단에 유용), --latency-dist는 히스토그램을, --latency-history는 롤링 통계를 보여줍니다. 성능 튜닝 전에 이 명령들로 연결 품질의 기준선을 잡아 두세요.
# basic connectivity test
redis-cli ping
# PONG
# ping with a message (echoed back)
redis-cli PING "hello"
# "hello"
# test auth + connection in one shot
redis-cli -a password PING
# check round-trip latency (continuous)
redis-cli --latency
# output: min: 0, max: 1, avg: 0.27 (3421 samples)
# latency histogram
redis-cli --latency-dist
# latency history (rolling, every 15s by default)
redis-cli --latency-history -i 1대화형 모드 팁
대화형 모드는 Redis 명령을 위한 REPL입니다. HELP <command>나 HELP @<group>은 내장 문서를 보여줍니다(인터넷 불필요). CONNECT는 세션 중 서버를 전환하고, CLEAR는 화면을 지웁니다. CLI는 따옴표로 묶인 문자열의 여러 줄 입력을 자동 감지합니다. 콜론(:)을 붙이면 :raw 같은 CLI 전용 명령을 실행합니다.
# start interactive mode
redis-cli
# inside the CLI:
127.0.0.1:6379> HELP SET # command help
127.0.0.1:6379> HELP @string # help for a command group
127.0.0.1:6379> SCAN 0 # any Redis command
# clear the screen
127.0.0.1:6379> CLEAR
# connect to a different server without restarting
127.0.0.1:6379> CONNECT host 6380
# exit
127.0.0.1:6379> EXIT
127.0.0.1:6379> QUIT
# multi-line input: end with a backslash
127.0.0.1:6379> SET mykey "this is \
a multi-line value"
# toggle raw output mode
127.0.0.1:6379> :raw데이터베이스 선택과 기초
Redis 데이터베이스는 같은 메모리를 공유하는 논리적 네임스페이스(0-15)이며, 격리된 스키마가 아닙니다. 대부분의 앱은 db 0만 사용합니다. FLUSHDB는 현재 db를, FLUSHALL은 모든 데이터를 지웁니다(주의!). 여러 db는 단일 스레드를 공유하므로 권장되지 않으 며, 인스턴스를 분리하거나 키 접두사를 쓰는 편이 좋습니다.
# Redis has 16 logical databases (0-15) by default
SELECT 0 # switch to database 0
SELECT 15 # switch to database 15
# move a key to another database
MOVE mykey 1
# flush the current database (DESTRUCTIVE)
FLUSHDB
# flush ALL databases (VERY DESTRUCTIVE)
FLUSHALL
# get the number of keys in the current db
DBSIZE
# swap two databases (Redis 4.0+)
SWAPDB 0 1도움말과 명령 탐색
COMMAND는 서버의 명령 테이블을 조회해 지원 기능과 인자 수(arity)를 파악하는 데 유용합니다. COMMAND DOCS(7.0+)는 구조화된 문서를 반환합니다. CLI의 HELP는 카테고리(@string, @hash, @server 등)별로 오프라인 문서를 보여줍니다. 모든 CLI 플래그와 옵션은 'redis-cli --help'로 확인하세요.
# list all commands (huge output)
COMMAND
# get details of a specific command
COMMAND INFO GET
COMMAND INFO SET HSET LPUSH
# structured documentation (Redis 7+)
COMMAND DOCS SET
COMMAND DOCS @string
# count available commands
COMMAND COUNT
# CLI help
redis-cli --help
redis-cli --version
# inside interactive mode
HELP
HELP @server
HELP @string
HELP @hash
HELP GETSET문자열
기본 SET과 GET
SET/GET은 가장 기본적인 문자열 연산입니다. NX는 키가 없을 때만 설정(락 구현에 사용), XX는 키가 있을 때만 설정합니다. EX/PX/EXAT/PXAT는 만료를 원자적으로 설정하므로 SET과 EXPIRE 사이의 경쟁 조건이 없습니다. GETSET은 새 값을 설정하면서 이전 값을 반환합니다. 문자열은 최대 512MB까지 바이너리 안전합니다.
# set and get a key
SET mykey "Hello"
GET mykey # "Hello"
# set only if not exists (NX) or only if exists (XX)
SET mykey "new" NX # set only if key does NOT exist
SET mykey "new" XX # set only if key DOES exist
# set with expiration (seconds / milliseconds)
SET token "abc" EX 3600 # expires in 3600s
SET token "abc" PX 60000 # expires in 60000ms
# set with expiration at a Unix timestamp
SET token "abc" EXAT 1700000000
# get and set atomically (returns old value)
GETSET counter 0 # returns old value, sets new
# delete a key
DEL mykey숫자 카운터(INCR/DECR)
INCR/DECR는 원자적이므로 락 없이도 동시 접근에 안전합니다. 그 래서 Redis는 카운터, 속도 제한(INCR + EXPIRE), 시퀀스 ID 생성에 적합합니다. INCRBYFLOAT은 소수를 지원하지만 배정밀도를 쓰므로 반올림에 주의하세요. 값이 정수가 아니면 INCR은 오류를 반환합니다.
# increment a numeric string atomically
SET counter 100
INCR counter # 101
INCRBY counter 10 # 111
# decrement
DECR counter # 110
DECRBY counter 5 # 105
# floating point increment
SET price "10.50"
INCRBYFLOAT price 0.25 # "10.75"
INCRBYFLOAT price -1.00 # "9.75"
# all increment ops are atomic and concurrency-safe
# use for: counters, rate limiting, sequence IDs, stats
# INCR on a non-integer value returns an error
SET mystr "hello"
INCR mystr # ERROR: value is not an integerAPPEND와 문자열 연산
APPEND는 문자열을 확장하고(없으면 생성), STRLEN은 길이를 반환합니다. GETRANGE/SETRANGE는 바이너리 안전하게 부분 문자열을 다룹니다. GETDEL(6.2+)은 값을 반환하면서 원자적으로 삭제하므로 일회성 읽기 패턴에 유용합니다. GETEX는 값을 반환하면서 TTL을 설정하므로 읽을 때 세션 만료를 갱신하기 좋습니다.
# append to a string value
SET msg "Hello"
APPEND msg " World" # "Hello World"
# get string length
STRLEN msg # 11
# get substring
GETRANGE msg 0 4 # "Hello"
GETRANGE msg 6 -1 # "World"
# overwrite a substring (grows if needed)
SETRANGE msg 6 "Redis" # "Hello Redis"
# get and delete atomically
GETDEL mykey # returns value AND deletes key
# get and set expiration atomically (6.2+)
GETEX mykey EX 3600 # returns value, sets TTL
# append only if key exists
APPEND existing_key "more"MSET과 MGET(배치 연산)
MSET/MGET은 여러 연산을 한 번의 왕복으로 묶으므로 성능에 필수입니다(Redis는 단일 스레드라 명령별 오버헤드가 중요합니다). MSETNX는 원자적이어서 모든 키가 설정되거나 하나도 설정되지 않습니다. 작은 키-값 쌍이 많다면 해시(HSET)로 묶어 listpack 인코딩의 메모리 효율을 활용하세요.
# set multiple keys at once (atomic)
MSET k1 "v1" k2 "v2" k3 "v3"
# get multiple keys at once
MGET k1 k2 k3 # 1) "v1" 2) "v2" 3) "v3"
# set multiple only if ALL keys are new
MSETNX k1 "v1" k4 "v4" # 1 if all set, 0 if any existed
# MSET/MGET reduce round-trips — much faster than
# separate SET/GET calls in a loop
# get the length of a string value
STRLEN k1 # 2
# set multiple fields of different keys is not possible;
# for per-field updates use hashes (HSET)
# pipeline alternative in CLI:
printf '%s\n' "SET k1 v1" "SET k2 v2" "GET k1" | redis-cli --pipe-mode비트맵(문자열 기반)
비트맵은 약 512MB로 최대 40억 사용자의 불리언 플래그를 저장할 수 있어 공간 효율이 매우 뛰어납니다. BITOP AND/OR/XOR/NOT은 비트맵을 결합합니다(예: 여러 날 활동한 사용자). BITCOUNT는 활성 사용자 수를 세고, BITFIELD는 여러 작은 카운터를 하나의 문자열에 패킹합니다. 위치가 곧 사용자 ID입니다. 활용 예: 일일 활성 사용자, 기능 플래그.
# bitmaps are strings operated on at the bit level
# great for boolean flags on a large user base
# set bit at position (0 or 1)
SETBIT user:1:active 7 1 # user 1 active
GETBIT user:1:active 7 # 1
# count set bits
BITCOUNT user:1:active # total bits set to 1
# bitwise operations between strings
SETBIT users:d1 5 1
SETBIT users:d2 5 1
BITOP AND active-both users:d1 users:d2
BITCOUNT active-both # users active on both days
BITOP OR active-either users:d1 users:d2
BITOP XOR diff users:d1 users:d2
# find the first set bit
BITPOS user:1:active 1 # position of first 1-bit
# bitfield: multiple counters in one string
BITFIELD mycnt SET u8 0 100
BITFIELD mycnt INCRBY u8 0 10문자열 만료와 TTL
TTL은 없는 키에 -2, 만료가 없는 키에 -1을 반환합니다. EX를 붙인 SET은 원자적이라 SET과 EXPIRE 사이의 경쟁 조건이 없습니다. KEEPTTL(6.0+)은 TTL을 유지한 채 값을 갱신하므로 만료 시간을 초기화하지 않고 캐시 값을 새로 고칠 때 유용합니다. 만료는 접근 시 확인하는 지연 방식과 주기적 백그라운드 스윕을 함께 사용합니다.
# set a key with expiration in one atomic command
SET session "data" EX 3600 # 1 hour
SET cache "value" PX 60000 # 60 seconds (ms)
# set expiration on an existing key
EXPIRE mykey 60 # 60 seconds
PEXPIRE mykey 60000 # 60 seconds (ms)
EXPIREAT mykey 1700000000 # Unix timestamp
# view remaining time to live
TTL mykey # seconds (-1 = no expiry, -2 = no key)
PTTL mykey # milliseconds
# remove expiration (make key persistent)
PERSIST mykey
# TTL with KEEPTTL option (6.0+): set value, keep existing TTL
SET mykey "newval" KEEPTTL리스트
푸시와 팝 연산
리스트는 양방향입니다. LPUSH+RPOP은 큐(FIFO), LPUSH+LPOP은 스택(LIFO)입니다. BLPOP/BRPOP은 항목이 생길 때까지 블록하므로 폴링 없이 Redis 큐를 만들 수 있는 기반입니다. BLPOP에는 반드시 타임아웃을 설정해 연결 끊김에 대비하세요. 리스트는 양 끝 연산이 O(1)이고 중간 접근은 O(N)입니다.
# lists are ordered sequences of strings (linked lists)
LPUSH mylist "a" "b" # list: [b, a]
RPUSH mylist "c" # list: [b, a, c]
# pop from head or tail
LPOP mylist # "b" (removes from head)
RPOP mylist # "c" (removes from tail)
# pop multiple (6.2+)
LPOP mylist 2 # pop 2 from head
# get length
LLEN mylist # 0
# blocking pop (waits if empty, up to timeout)
BLPOP queue:tasks 30 # blocks up to 30 seconds
BRPOP queue:tasks 0 # blocks forever
# push only if the list exists (don't create new key)
LPUSHX mylist "x" # 0 if key doesn't existLRANGE와 인덱싱
LRANGE 0 -1은 리스트 전체를 반환합니다. LINDEX는 중간 요소에 O(N)이 걸립니다. 리스트는 끝부분 접근에 최적화되어 있기 때문입니다. LSET은 인덱스로 값을 수정하고, LINSERT는 O(N)이므로 큰 리스트에서는 신중히 사용하세요. LPOS는 요소를 제거하지 않고 위치를 찾습니다. 인덱스로 자주 무작위 접근해야 한다면 리스트는 잘못된 선택이며 정렬된 집합을 고려하세요.
# get a range of elements (0-based, negative from end)
LRANGE mylist 0 -1 # all elements
LRANGE mylist 0 2 # first 3 elements
LRANGE mylist -3 -1 # last 3 elements
# get element by index (O(N) traversal)
LINDEX mylist 0 # first element
LINDEX mylist -1 # last element
# set an element by index
LSET mylist 1 "newval"
# get length
LLEN mylist
# insert before or after a pivot element
LINSERT mylist BEFORE "pivot" "new"
LINSERT mylist AFTER "pivot" "new"
# find the position of an element (6.0+)
LPOS mylist "value"
LPOS mylist "value" RANK 2 # find 2nd occurrence블로킹 팝과 큐
BRPOPLPUSH/BLMOVE는 항목을 원본에서 대상으로 원자적으로 이동합니다. 소비자는 안전하게 처리할 수 있고, 처리 중 크래시가 나도 항목은 대상 리스트에 남습니다(신뢰성 있는 큐 패턴). BRPOP 후 처리하다 크래시가 나면 항목을 잃는 방식보다 낫습니다. 처리 후에는 대상 리스트에서 삭제하세요.
# simple FIFO queue: LPUSH to add, RPOP to consume
LPUSH tasks "job1" "job2"
RPOP tasks # "job1" (FIFO order)
# reliable queue with BRPOP (blocking, waits for work)
BRPOP tasks 0 # blocks until a task is available
# move items between lists atomically
RPOPLPUSH source destination # move one item
# blocking move (reliable queue pattern)
BRPOPLPUSH source destination 30 # blocks up to 30s
# Redis 6.2+: BLMOVE replaces BRPOPLPUSH
BLMOVE source destination RIGHT LEFT 30
# capped queue (e.g., recent events)
LPUSH recent "event"
LTRIM recent 0 99 # keep latest 100LREM, LSET, LTRIM
LTRIM은 리스트 크기를 제한하는 흔한 패턴입니다(예: 최근 100개 이벤트만 유지). LREM은 값으로 제거합니다(count가 양수면 앞에서, 음수면 뒤에서, 0이면 전체). LMPOP(7.0+)은 여러 리스트에서 한 번에 팝하므로 우선순위 큐에 유용합니다. 리스트 중간에서 자주 연산해야 한다면 리스트는 적합하지 않습니다.
# trim to a range (removes everything outside)
LTRIM mylist 0 99 # keep only first 100 elements
LTRIM mylist -50 -1 # keep only last 50
# remove elements by value
LREM mylist 2 "value" # remove first 2 occurrences of "value"
LREM mylist -2 "value" # remove last 2 occurrences
LREM mylist 0 "value" # remove ALL occurrences
# pop and push in one atomic operation
RPOPLPUSH source dest
# pop from multiple lists (7.0+)
LMPOP 2 mylist1 mylist2 LEFT COUNT 3
# blocking pop from multiple lists (7.0+)
BLMPOP 30 2 mylist1 mylist2 LEFT COUNT 3
# remove a key only if it's a list (type-safe)
DEL mylist # works on any type리스트 활용 사례
리스트는 끝부분 접근 패턴이 있는 시퀀스에 가장 적합합니다: 큐, 스택, 피드, 버퍼. LTRIM을 쓰면 크기가 제한된 로그/피드에 이상적입니다. 속도 제한에는 타임스탬프 리스트와 LTRIM으로 간단한 슬라이딩 윈도우를 만들 수 있습니다. 정렬/우선순위 큐가 필요하면 정렬된 집합을 사용하세요. 리스트는 중복 제거를 지원하지 않으므로 그 용도에는 집합을 쓰세요.
# 1. Task queue (FIFO)
LPUSH tasks "process_order:123"
BRPOP tasks 30
# 2. Recent activity feed (capped)
LPUSH user:1:feed "post:99" "post:98"
LTRIM user:1:feed 0 49 # latest 50
# 3. Stack (LIFO)
LPUSH stack "item"
LPOP stack
# 4. Circular buffer (limited size)
LPUSH buffer "new"
LTRIM buffer 0 999 # keep 1000 items
# 5. Rate limiter (sliding window)
LPUSH rate:user:1 1700000000
LTRIM rate:user:1 0 99
LLEN rate:user:1 # request count in window
# 6. Chat history (capped)
LPUSH chat:room:1 "alice: hello"
LTRIM chat:room:1 0 999 # keep last 1000 messages집합
SADD, SMEMBERS, SISMEMBER
집합은 고유 값을 저장하므로 태그, 카테고리, 중복 제거에 완벽합니다. SISMEMBER는 O(1)이라 리스트 확인보다 훨씬 빠릅니다. SMEMBERS는 큰 집합에서 서버를 막을 수 있으므로 반복에는 SSCAN을 사용하세요. SMISMEMBER(7.4+)는 여러 멤버를 한 번에 확인해 왕복을 줄입니다. 모든 멤버가 정수이면 intset(정렬 배열)을 사용해 메모리 효율이 매우 높습니다.
# sets: unordered collection of unique strings
SADD tags "redis" "db" "cache"
SADD tags "redis" # ignored (already exists)
# check membership (O(1))
SISMEMBER tags "redis" # 1 if member, 0 if not
# get all members (avoid on large sets)
SMEMBERS tags # 1) "redis" 2) "db" 3) "cache"
# get the number of members
SCARD tags # 3
# remove a member
SREM tags "cache" # 1
# check multiple memberships at once (7.4+)
SMISMEMBER tags "redis" "db" "missing"
# 1) 1 2) 1 3) 0집합 연산(합집합/교집합/차집합)
집합 연산은 Redis의 강력한 기능입니다. 합집합, 교집합, 차집합을 클라이언트 처리 없이 O(N)에 수행합니다. 활용 예: 상호 친구(SINTER), 순 방문자(SUNION), 태그 기반 필터링(태그 집합의 SINTER). SINTERCARD(7.0+)는 개수만 반환하므로 멤버가 필요 없을 때 더 빠릅니다. 결과를 저장해 재계산을 피하세요.
# set union, intersection, difference
SADD set1 "a" "b" "c"
SADD set2 "b" "c" "d"
# union (all unique members from all sets)
SUNION set1 set2 # a, b, c, d
# intersection (members in ALL sets)
SINTER set1 set2 # b, c
# difference (members in set1 but NOT in set2)
SDIFF set1 set2 # a
# store the result in a new set
SUNIONSTORE result set1 set2
SINTERSTORE result set1 set2
SDIFFSTORE result set1 set2
# count intersection without returning members (7.0+)
SINTERCARD 2 set1 set2 LIMIT 0
# operations on multiple sets at once
SUNION s1 s2 s3 s4SREM, SMOVE, SPOP
SMOVE는 원자적이므로 상태 전이에 유용합니다(예: 사용자를 'pending'에서 'active' 집합으로 이동). SPOP은 무작위 멤버를 제거합니다(추첨/샤딩에 유용). SRANDMEMBER는 제거하지 않습니다. BSPOP(7.0+)은 집합용 BLPOP처럼 블록하며, 순서가 중요하지 않은 이벤트 기반 패턴에 유용합니다. SREM은 실제로 제거된 개수를 반환합니다.
# remove one or more members
SADD myset "a" "b" "c" "d"
SREM myset "a" "b" # 2 (number removed)
# move a member from one set to another atomically
SMOVE source dest "member"
# pop a random member (removes it)
SPOP myset # removes and returns one
SPOP myset 3 # removes and returns 3 (6.2+)
# get a random member (does NOT remove)
SRANDMEMBER myset # one random member
SRANDMEMBER myset 3 # 3 random (may repeat)
SRANDMEMBER myset -3 # 3 unique random
# blocking set pop (7.0+) - waits until a member exists
BSPOP myset 30 # blocks up to 30 seconds
# delete the entire set
DEL mysetSSCAN 반복
SSCAN은 큰 집합을 안전하게 반복하는 방법입니다. SMEMBERS는 거대한 집합에서 서버를 막습니다. SSCAN은 커서 기반이라 커서가 0으로 돌아올 때까지 반복 호출합니다. COUNT는 힌트일 뿐이라 더 많거나 적게 반환될 수 있습니다. SSCAN은 약한 보장을 제공합니다. 반복 중 추가된 멤버를 놓치거나 중복을 반환할 수 있지만 절대 블록하지 않습니다. 코드에서 항상 커서 루프를 처리하세요.
# SSCAN: cursor-based iteration for large sets
SSCAN myset 0 MATCH "pre*" COUNT 100
# returns: [nextCursor, [member1, member2, ...]]
# continue until cursor returns to 0
SSCAN myset <nextCursor> MATCH "pre*" COUNT 100
# iterate all members safely
cursor=0
while true:
cursor, members = SSCAN myset cursor COUNT 100
process(members)
if cursor == 0: break
# scan with type filtering (7.0+ for SCAN, sets always same type)
# COUNT is a hint, not exact (may return more or fewer)
# MATCH pattern supports glob: *, ?, [abc]
SSCAN myset 0 MATCH "user:*" COUNT 1000
# for small sets, SMEMBERS is fine
# for large sets (>10k), always use SSCAN집합 활용 사례
집합은 고유성과 관계 표현에 최적입니다. 상호 팔로워/친구를 구하는 SINTER 패턴은 고전적입니다. 카디널리티가 큰 '일별 방문자'에는 HyperLogLog(근사치지만 12KB 고정)를 고려하세요. 순서가 있는 고유 데이터(리더보드)에는 정렬된 집합을 사용하세요. 집합은 순서가 없으므로 순서가 중요하면 리스트나 정렬된 집합을 쓰세요.
# 1. Tags / categories
SADD post:1:tags "redis" "db"
SADD post:2:tags "redis" "cache"
SINTER post:1:tags post:2:tags # posts sharing "redis"
# 2. Unique visitors per day
SADD visitors:2025-01-01 "user:1" "user:2"
SCARD visitors:2025-01-01 # visitor count
# 3. Followers / following (mutual friends)
SADD user:1:following "user:2" "user:3"
SADD user:2:following "user:1" "user:3"
SINTER user:1:following user:2:following # mutual follows
# 4. Blacklist / whitelist
SADD blacklist "ip:1.2.3.4"
SISMEMBER blacklist "ip:1.2.3.4" # 1 = blocked
# 5. Lottery / random selection
SADD participants "u1" "u2" "u3" "u4"
SPOP participants 1 # draw a winner정렬된 집합
ZADD, ZSCORE, ZRANK
정렬된 집합(zset)은 Redis에서 가장 강력한 구조입니다. 고유 멤버를 점수순으로 정렬하며 연산은 O(log N)입니다. ZADD 옵션(NX/XX/GT/LT)으로 조건부 갱신이 가능합니다. GT는 새 점수가 더 클 때만 갱신하므로 '최고 점수' 추적에 좋습니다. 점수는 double이고 멤버는 고유합니다. 점수가 같으면 사전순으로 정렬됩니다.
# sorted set: unique members ordered by a float score
ZADD leaderboard 100 "alice" 200 "bob" 150 "carol"
# update a score (re-add with new score)
ZADD leaderboard 250 "alice" # alice's score becomes 250
# add with options (NX: only new, XX: only existing, GT/LT)
ZADD leaderboard NX 300 "new" # only if new
ZADD leaderboard GT 300 "alice" # only if new score > current
ZADD leaderboard LT 50 "alice" # only if new score < current
# get a member's score
ZSCORE leaderboard "alice" # "250"
# get a member's rank (0-based, ascending)
ZRANK leaderboard "alice" # rank from lowest
ZREVRANK leaderboard "alice" # rank from highest (0 = top)
# get the number of members
ZCARD leaderboard # 3
# get multiple scores at once (6.2+)
ZMSCORE leaderboard "alice" "bob" # ["250", "200"]ZRANGE와 ZREVRANGE
ZRANGE는 순위(인덱스)로 반환하고, BYSCORE를 붙이면 점수 범위로 반환합니다. Redis 6.2는 ZRANGEBYSCORE/ZREVRANGE를 ZRANGE의 BYSCORE/BYLEX/REV 옵션으로 통합했습니다. WITHSCORES는 출력에 점수를 포함합니다. 리더보드에서는 ZRANGE 0 9 REV로 상위 10개를 얻습니다. ZRANGESTORE(6.2+)는 결과를 새 키에 저장해 나중에 처리할 수 있습니다.
# get members by index range (ascending)
ZRANGE leaderboard 0 -1 # all, ascending
ZRANGE leaderboard 0 2 # first 3 (lowest scores)
ZRANGE leaderboard -3 -1 # last 3 (highest scores)
# descending order
ZREVRANGE leaderboard 0 2 # top 3 (highest scores)
# with scores
ZRANGE leaderboard 0 -1 WITHSCORES
# Redis 6.2+: unified ZRANGE with BYSCORE/REV options
ZRANGE leaderboard 100 200 BYSCORE
ZRANGE leaderboard 200 100 BYSCORE REV
# store a range in a new key (6.2+)
ZRANGESTORE top3 leaderboard 0 2 REV
# get by rank with scores
ZRANGE leaderboard 0 9 REV WITHSCORES # top 10
# limit results (pagination)
ZRANGE leaderboard 0 -1 BYSCORE LIMIT 0 10ZRANGEBYSCORE와 ZCOUNT
ZRANGEBYSCORE는 점수 범위로 반환하며, '(' 접두사는 해당 점수를 제외합니다. ZCOUNT는 멤버를 가져오지 않고 범위 내 개수를 구합니다. ZINCRBY는 점수를 원자적으로 조정하고 재정렬하므로 실시간 리더보드에 완벽합니다. ZREMRANGEBYRANK는 zset 크기를 제한하는 데 좋습니다(예: 상위 1000개만 유지).
# get members by score range
ZRANGEBYSCORE leaderboard 100 200 # scores 100-200
ZRANGEBYSCORE leaderboard 100 +inf # scores >= 100
ZRANGEBYSCORE leaderboard -inf 200 # scores <= 200
ZRANGEBYSCORE leaderboard (100 200 # scores > 100 (exclusive)
# with pagination
ZRANGEBYSCORE leaderboard 100 200 LIMIT 0 10
# count members in a score range
ZCOUNT leaderboard 100 200
# increment a member's score atomically
ZINCRBY leaderboard 50 "alice" # alice += 50
# remove a member
ZREM leaderboard "bob"
# remove by rank range
ZREMRANGEBYRANK leaderboard 0 9 # remove lowest 10
ZREMRANGEBYSCORE leaderboard 0 100 # remove scores <= 100ZUNIONSTORE와 ZINTERSTORE
ZUNIONSTORE/ZINTERSTORE는 집계 방식(SUM/MIN/MAX)과 가중치를 지정해 zset을 결합합니다. 가중 점수 계산에 강력합니다(예: 관련도 = 텍스트 일치*2 + 최신성*1). Redis 6.2는 저장 없이 결과를 반환하는 ZUNION/ZINTER/ZDIFF를 추가했습니다(명령 하나 절약). 이들은 O(N*M)이므로 큰 집합이 많을 때 주의하세요. 집합 개수를 집합 이름보다 먼저 지정해야 합니다.
# combine multiple sorted sets
ZADD set1 1 "a" 2 "b"
ZADD set2 2 "a" 3 "c"
# union: sum scores by default (a = 1+2 = 3)
ZUNIONSTORE result 2 set1 set2
ZRANGE result 0 -1 WITHSCORES # a=3, b=2, c=3
# specify aggregation: SUM (default), MIN, MAX
ZUNIONSTORE result 2 set1 set2 AGGREGATE MAX # a=2, b=2, c=3
# apply weights to each set's scores
ZUNIONSTORE result 2 set1 set2 WEIGHTS 2 1 # set1 scores * 2
# intersection (only members in ALL sets)
ZINTERSTORE result 2 set1 set2 # only "a"
# Redis 6.2+: return without storing
ZUNION 2 set1 set2 WITHSCORES
ZINTER 2 set1 set2 WITHSCORES
ZDIFF 2 set1 set2 WITHSCORES
# count intersection (7.0+)
ZINTERCARD 2 set1 set2 LIMIT 0사전순 범위(BYLEX)
BYLEX는 점수가 모두 같을 때 멤버에 대한 범위 쿼리를 가능하게 하여, 정렬된 집합을 자동 정렬 문자열 인덱스로 바꿉니다. 활용 예: 자동 완성(단어를 점수 0으로 저장하고 접두사 범위 조회), 정렬된 사전. '[a'는 포함, '(a'는 제외, '-'는 시작, '+'는 끝을 뜻합니다. 모든 점수가 동일할 때만 의미 있게 동작합니다.
# when all scores are equal, sorted sets act as a sorted string set
ZADD myset 0 "apple" 0 "banana" 0 "cherry" 0 "date"
# range by lexicographical order
ZRANGEBYLEX myset "[a" "[c" # apple, banana, cherry
ZRANGEBYLEX myset "(a" "[c" # banana, cherry (a exclusive)
ZRANGEBYLEX myset "-" "[b" # from start to banana
ZRANGEBYLEX myset "[c" "+" # cherry to end
# count in a lex range
ZLEXCOUNT myset "[a" "[c" # 3
# remove by lex range
ZREMRANGEBYLEX myset "[a" "[b"
# Redis 6.2+: use ZRANGE with BYLEX
ZRANGE myset "[a" "[c" BYLEX
# limit results (pagination)
ZRANGEBYLEX myset "[a" "[c" LIMIT 0 10리더보드 패턴
정렬된 집합으로 리더보드는 간단해집니다. ZADD로 점수를 갱신하고, ZREVRANGE로 상위 N개를, ZREVRANK로 플레이어 순위를 얻습니다. ZINCRBY는 점수를 원자적으로 갱신합니다. 기간별 리더보드(일간/주간)에는 기간마다 키를 만들고 TTL을 설정하세요. 페이지네이션은 오프셋과 ZREVRANGE를 사용합니다. Redis의 가장 자연스럽고 강력한 활용 사례 중 하나입니다.
# build a leaderboard
ZADD leaderboard 100 "alice" 250 "bob" 150 "carol"
# top 10 players (highest scores)
ZREVRANGE leaderboard 0 9 WITHSCORES
# a player's rank (0 = top)
ZREVRANK leaderboard "alice"
# update a score (atomic)
ZINCRBY leaderboard 50 "alice"
# players within a score range (e.g., silver tier 100-199)
ZRANGEBYSCORE leaderboard 100 199
# percentile rank
total = ZCARD(leaderboard)
rank = ZREVRANK(leaderboard "alice")
# percentile = (total - rank) / total * 100
# pagination (page 3, 10 per page)
ZREVRANGE leaderboard 20 29 WITHSCORES
# time-bucketed leaderboards (weekly)
ZADD leaderboard:2025-W01 100 "alice"
EXPIRE leaderboard:2025-W01 604800 # 1 week TTL해시
HSET, HGET, HGETALL
해시는 객체 저장에 이상적입니다. 객체마다 키 하나, 속성마다 필드 하나를 둡니다. 이는 JSON 직렬화보다 낫습니다. 읽기-수정-쓰기 없이 개별 필드를 원자적으로 갱신(HSET)할 수 있기 때문입니다. HGETALL은 모든 필드를 반환하지만 큰 해시에는 HSCAN을 권장합니다. 해시는 작을 때(약 128개 필드 미만) listpack 인코딩을 사용해 메모리 효율이 좋습니다.