JSON
JSON (JSON) (json)
Redis 공식 문서의 json 페이지를 한국어로 풀어드릴게요. 옆에서 하나씩 설명해 드리는 느낌으로 읽으시면 돼요.
Redis에서 JSON(JavaScript Object Notation) 데이터 타입을 어떻게 지원하는지 알려드릴게요. Redis Open Source의 JSON 기능을 쓰면 다른 Redis 데이터 타입처럼 Redis 데이터베이스에 JSON 값을 저장·업데이트·조회할 수 있어요. Redis JSON은 Redis Search와 매끄럽게 연동되어 JSON 문서를 인덱싱하고 쿼리할 수도 있어요.
주요 기능 (Primary features)
- JSON 표준의 완전한 지원
- 문서 안 요소를 선택/업데이트하기 위한 JSONPath 구문 (자세한 내용은 JSONPath syntax 참고)
- 문서가 트리 구조의 바이너리 데이터로 저장되어 하위 요소에 대한 빠른 접근 가능
첫 번째 JSON 명령
가장 먼저 시도할 JSON 명령은 JSON.SET이에요. Redis 키에 JSON 값을 설정하는 명령이죠. JSON.SET은 모든 JSON 값 타입을 받아들여요. 이 예시는 JSON string을 만들어요.
명령: JSON.SET, JSON.GET, JSON.TYPE
복잡도(Complexity):
- JSON.SET: O(M+N)
- JSON.GET: O(N)
- JSON.TYPE: O(1)
사용 가능한 곳: Redis CLI, C#, Go, Java (Asynchronous - Lettuce), Java (Reactive - Lettuce), Java (Synchronous - Jedis), JavaScript (Node.js), PHP, Python, Rust (Asynchronous), Rust (Synchronous)
Redis CLI
> JSON.SET bike $ '"Hyperion"'
> OK
> JSON.GET bike $
> "["Hyperion"]"
> JSON.TYPE bike $
1) "string"
문자열 연산 (JSON.STRLEN, JSON.STRAPPEND)
JSON.STRLEN으로 길이를, JSON.STRAPPEND로 문자열 값을 이어붙일 수 있어요. (난이도: beginner)
숫자 연산 (JSON.NUMINCRBY, JSON.NUMMULTBY)
JSON.NUMINCRBY로 JSON 숫자를 증분하고 JSON.NUMMULTBY로 곱하는 원자적(atomic) 산술 연산을 할 수 있어요. (난이도: beginner)
배열 연산 (JSON.ARRAPPEND, JSON.ARRINSERT, JSON.ARRTRIM, JSON.ARRPOP)
JSON.ARRAPPEND로 요소를 추가하고, JSON.ARRINSERT로 위치에 삽입하고, JSON.ARRTRIM으로 범위를 유지하고, JSON.ARRPOP으로 요소를 제거할 수 있어요. (난이도: intermediate)
객체 연산 (JSON.OBJLEN, JSON.OBJKEYS)
JSON.OBJLEN으로 필드 수를 세고 JSON.OBJKEYS로 모든 키를 가져오는 식으로 JSON 객체를 검사할 수 있어요. (난이도: intermediate)
Redis 8.8 이후의 FPHA 지원
Redis 8.8부터 JSON 데이터 타입은 부동소수점 동질 배열(FPHAs, floating point homogeneous arrays)을 저장할 때 특정 타입을 강제하는 기능을 지원해요. JSON.SET 명령에 FPHA BF16|FP16|FP32|FP64 옵션을 쓰면 돼요.
JSON.SET fp BF16 $
'[1.1, 2.2, 3.3]'
JSON 명령 요약
| 명령 | 설명 | 복잡도 | 버전 |
|---|---|---|---|
| JSON.ARRAPPEND | path에서 배열 끝(마지막 요소 다음)에 하나 이상의 JSON 값을 추가 | path가 단일 값으로 평가되면 O(1), ... | 1.0.0 |
| JSON.ARRINDEX | path에서 배열에서 JSON 스칼라 값의 첫 번째 발생 인덱스 반환 | path가 단일 값으로 평가되면 O(N), ... | 1.0.0 |
(이외에도 JSON.SET, JSON.GET, JSON.TYPE, JSON.OBJLEN, JSON.OBJKEYS 등 다양한 명령이 있어요.)
Redis JSON 활성화
Redis JSON 데이터 타입은 Redis Open Source의 일부이며, Redis Software와 Redis Cloud에서도 사용할 수 있어요.
설치 방법은 Redis Open Source 설치나 Redis Software 설치 문서를 참고하세요.
더 알아보기 (Learn more)
JSON 데이터 타입에 대해 더 알고 싶다면 아래 링크를 확인해 보세요.