JSONB는 어떻게 동작하며 언제 사용해야 하나요?

Question

Accepted Answer

**`JSONB`**는 PostgreSQL의 바이너리 JSON 타입입니다 — JSON 데이터를 효율적이고 **쿼리 가능하며 인덱싱 가능한** 형식으로 저장합니다. 관계형 데이터베이스에 유연한 반정형 데이터를 저장하게 해주어 관계형 무결성과 NoSQL 같은 유연성을 결합합니다. Postgres의 가장 강력한 기능 중 하나입니다.

## JSONB vs JSON

```text
JSON  → 정확한 텍스트 저장 (공백/키 순서/중복 보존), 매 쿼리 파싱
JSONB → 분해된 바이너리 형식 저장 → 쓰기는 약간 느리지만, 쿼리는 훨씬 빠르고
        인덱싱과 풍부한 연산자 지원
→ 거의 모든 경우 JSONB 사용 (정확한 텍스트 보존이 필요할 때만 JSON).
```

## JSONB 저장 및 쿼리

```sql
CREATE TABLE products (id SERIAL, attributes JSONB);
INSERT INTO products (attributes) VALUES
  ('{"color": "red", "size": "L", "tags": ["new", "sale"]}');

-- 값 추출
SELECT attributes->'color'   FROM products;   -- -> JSONB 반환: "red"
SELECT attributes->>'color'  FROM products;   -- ->> TEXT 반환: red
SELECT attributes#>>'{tags,0}' FROM products; -- 중첩 경로: 첫 태그

-- 내용으로 쿼리
SELECT * FROM products WHERE attributes->>'color' = 'red';
SELECT * FROM products WHERE attributes @> '{"color": "red"}';  -- 포함
SELECT * FROM products WHERE attributes ? 'color';              -- 키 존재
```

연산자: `->`(JSONB 필드 얻기), `->>`(텍스트로 얻기), `@>`(포함), `?`(키 존재), `#>>`(중첩 경로). 이것들이 JSONB를 풍부하게 쿼리 가능하게 만듭니다 — JSON을 평문으로 저장하는 것과 달리.

## JSONB 인덱싱 (성능의 핵심)

```sql
-- GIN index가 포함/키 쿼리를 빠르게 함
CREATE INDEX idx_attrs ON products USING GIN (attributes);
-- 이제 WHERE attributes @> '{"color": "red"}'가 index 사용

-- 또는 특정 추출 필드 인덱싱
CREATE INDEX idx_color ON products ((attributes->>'color'));
```

## JSONB를 사용할 때 (그리고 사용하지 말아야 할 때)

```text
✓ 사용: 유연한/가변 속성, 설정, API 페이로드, 희소 필드,
  행마다 다른 반정형 데이터, 또는 빠르게 진화하는 스키마
✗ 회피: 잘 구조화되고 관계형으로 쿼리되는 데이터 → 일반 컬럼 사용
  (더 나은 제약조건, 타입, 구조화 쿼리에 보통 더 나은 성능)
→ 둘 다 혼합: 구조화 데이터는 컬럼에, 가변/유연 데이터는 JSONB 컬럼에.
```

## 왜 중요한가

JSONB는 PostgreSQL의 가장 중요하고 독특한 기능 중 하나이며, 이를 이해하는 것은 매우 가치가 있습니다. **관계형 데이터베이스 내에서 반정형 데이터를 저장하고 효율적으로 쿼리**하게 해주어 — Postgres의 무결성, transaction, 관계형 능력을 문서/NoSQL 저장소의 유연성과 결합하기 때문이며, 이는 현대 애플리케이션의 주요 능력입니다.

JSON을 평문(또는 `JSON` 타입)으로 저장하는 것 대비 핵심 장점은 **JSONB가 쿼리 가능하고 인덱싱 가능**하다는 것입니다. 풍부한 연산자(`->`, `->>`, `@>`, `?`)로 JSON 내용을 추출하고 필터링하며, **GIN index**(또는 추출 필드 인덱스)가 이 쿼리를 빠르게 만들어 — 쿼리 성능을 희생하지 않고 문서 저장소 같은 유연성을 얻습니다.

이는 JSONB를 유연하거나 가변적인 속성, 설정, API 페이로드, 희소 데이터, 진화하는 스키마에 이상적으로 만듭니다 — 그렇지 않으면 NoSQL 데이터베이스나 어색한 스키마 설계가 필요한 흔한 현대적 필요입니다.

**JSONB vs JSON** 구분(거의 모든 경우 JSONB), 쿼리 연산자, **인덱싱**(성능에 필수), 결정적으로 **JSONB 대 일반 컬럼을 언제 사용할지**(유연한/가변/반정형 데이터에는 JSONB, 잘 구조화되고 관계형으로 쿼리되는 데이터에는 일반 컬럼 — 흔히 둘 다 혼합)를 이해하면 성숙한 설계 판단을 반영합니다.

유연한 반정형 데이터를 다루는 능력이 점점 중요해지고, JSONB가 견고한 관계형 데이터베이스 내에서 이를 제공(흔히 별도 NoSQL 저장소의 필요를 제거)하므로, JSONB — 쿼리, 인덱싱, 적절한 사용 — 를 이해하는 것은 PostgreSQL이 현대 애플리케이션에 그토록 인기 있는 핵심 이유이자 Postgres의 전체 능력을 활용하는 상징인 가치 있고 자주 관련되는 지식입니다.