jsonb는 PostgreSQL의 바이너리 JSON 컬럼 타입입니다. ->(jsonb 반환)와 ->>(text 반환)로 필드를 읽고, 포함 연산자 @>로 행을 찾고, jsonb_set이나 ||로 필드를 바꿉니다. GIN 인덱스를 두면 이런 쿼리가 빨라집니다.
주문 1과 3이 조건에 맞습니다. data->'customer'는 중첩된 객체를 jsonb로 돌려주고, ->>'name'은 이름을 텍스트로 꺼내며, ->>에 형 변환을 더하면 total이 숫자가 됩니다.
JSONB에서 값 꺼내기
| 연산자 | 반환 타입 | 예시 |
|---|---|---|
-> 키 또는 인덱스 | jsonb | data->'customer', data->'tags'->0 |
->> 키 또는 인덱스 | text | data->>'status' |
#> 경로 | jsonb | data#>'{customer,city}' |
#>> 경로 | text | data#>>'{customer,city}' |
[...] 첨자 (PostgreSQL 14+) | jsonb | data['customer']['city'] |
배열 인덱스는 0부터 시작하고, 음수 인덱스는 끝에서부터 셉니다(-> -1은 마지막 요소). 없는 키는 오류가 아니라 SQL NULL을 돌려주므로, 위의 주문 3은 city가 NULL입니다.
텍스트와 비교하거나 형 변환할 때는 ->>를 쓰세요: data->>'status' = 'paid'. 계속 따라 내려갈 때는 ->를 씁니다. 흔한 실수는 data->'status' = 'paid'입니다. PostgreSQL은 'paid'를 JSON으로 읽는데, 따옴표 없는 단어는 올바른 JSON이 아니어서 "invalid input syntax for type json" 오류로 쿼리가 실패합니다.
JSON 내용으로 행 찾기
@>는 왼쪽 값이 오른쪽 값을 포함하는지 검사합니다. 어떤 깊이에서도, 배열 안에서도 동작하며 GIN 인덱스를 쓸 수 있습니다:
상품 1과 2는 M 사이즈와 가격이 있고, 30보다 비싼 것은 2뿐입니다. 검색 연산자는 다음과 같습니다:
@>는 포함함,<@는 포함됨.?는 키(또는 배열 안의 문자열)가 있음,?|는 키 중 하나라도 있음,?&는 모두 있음.@?와@@는 JSON path 쿼리를 실행합니다(PostgreSQL 12+). 문서 안에서 값을 비교할 때 씁니다.
JSONB 안의 필드 수정하기
PostgreSQL은 업데이트할 때마다 값 전체를 다시 쓰지만, 다음 함수를 쓰면 바뀌는 부분만 적을 수 있습니다:
jsonb_set(target, path, new_value)는 경로 하나의 값을 바꿉니다.-는 키를 지우고,#-는'{notify,sms}'같은 중첩 경로를 지웁니다.||는 최상위 키를 추가하거나 덮어씁니다.
PostgreSQL 14부터는 첨자로 대입할 수도 있습니다: SET prefs['notify']['email'] = 'false'.
함정이 두 가지 있습니다:
- 새 값이 SQL
NULL이면jsonb_set은NULL을 돌려주고, 그러면UPDATE가 컬럼 전체를 지워 버립니다.COALESCE(to_jsonb(x), 'null')을 넘기거나, 기본으로 JSONnull을 저장하는jsonb_set_lax(PostgreSQL 13+)를 쓰세요. jsonb_set은 없는 마지막 키는 추가하지만, 없는 부모 키는 만들지 않습니다.{}에'{a,b}'를 설정하면 그대로 남습니다. 첨자 대입은 부모도 만들어 줍니다.
JSON 배열을 행으로 바꾸기
jsonb_array_elements는 배열 요소마다 한 행을 돌려주고, jsonb_to_recordset은 객체 배열을 타입이 있는 컬럼으로 바꿉니다. PostgreSQL 17부터는 표준 JSON_TABLE 하나로 둘 다 할 수 있습니다:
A-1은 3개, B-2는 1개 팔렸습니다. 반대 방향으로는 jsonb_build_object('id', id, 'name', name)가 컬럼으로 객체를 만들고, jsonb_agg가 행을 배열로 모읍니다(string_agg와 array_agg 참고).
GIN으로 JSONB 인덱싱하기
컬럼 전체에 건 GIN 인덱스는 @>, ?, ?|, ?&, @?, @@에 쓰입니다:
CREATE INDEX orders_data_idx ON orders USING gin (data);
-- smaller and faster, but only for @>, @? and @@
CREATE INDEX orders_data_path_idx ON orders USING gin (data jsonb_path_ops);
-- one field compared with = or a range: a B-tree on the expression
CREATE INDEX orders_status_idx ON orders ((data->>'status'));
쿼리는 인덱스가 지원하는 형태로 쓰세요. WHERE data @> '{"status": "paid"}'는 GIN 인덱스를 쓸 수 있습니다. WHERE data->>'status' = 'paid'는 쓸 수 없고, 식 인덱스가 필요합니다. (data->>'total')::numeric > 50 같은 범위 검사에는 바로 그 식에 대한 식 인덱스가 필요합니다.
json과 jsonb 차이
json | jsonb | |
|---|---|---|
| 저장 방식 | 입력한 텍스트 그대로 | 파싱된 바이너리 형태 |
| 공백, 키 순서, 중복 키 | 유지 | 제거, 중복 키는 마지막 것만 남음 |
| 쓰기 | 조금 더 빠름(검증만 함) | 입력할 때 파싱 |
| 읽기와 조회 | 접근할 때마다 다시 파싱 | 빠름 |
@>, ?, GIN 인덱스 | 없음 | 있음 |
json은 텍스트를 그대로 돌려주고, jsonb는 "a": 3만 남기고 키 순서를 바꿉니다. 저장해 둔 웹훅 페이로드처럼 원래 텍스트를 바이트 단위로 그대로 돌려줘야 하는 경우가 아니라면 jsonb를 쓰세요. 모든 행에 있는 필드나 외래 키가 필요한 필드는 일반 컬럼에 두세요. 모든 연산자와 함수는 JSON 함수 공식 문서에 나와 있습니다.
자주 묻는 질문
PostgreSQL에서 -> 와 ->> 는 무엇이 다른가요?
->는 값을 jsonb로 돌려주므로 계속 따라 내려갈 수 있습니다(data->'customer'->'city'). ->>는 text로 돌려주며, 문자열과 비교하거나 숫자로 형 변환할 때 씁니다: (data->>'total')::numeric.
JSONB 배열에 어떤 값이 들어 있는지 어떻게 확인하나요?
포함 연산자를 쓰세요: data->'tags' @> '["gift"]', 또는 문서 최상위에서 검사하려면 data @> '{"tags": ["gift"]}'입니다. 문자열 배열이라면 data->'tags' ? 'gift'도 됩니다. data에 GIN 인덱스를 두면 두 번째 형태가 빨라집니다.
JSONB는 키 순서를 유지하나요?
아니요. jsonb는 키를 자체 순서로 저장하고, 공백을 없애며, 중복된 키는 마지막 것만 남깁니다. 원래 텍스트를 그대로 돌려받아야 한다면 json 타입을 쓰세요.
JSONB에 키가 있는지 어떻게 확인하나요?
data ? 'key'는 최상위 객체에 그 키가 있으면 참입니다. 값이 JSON null이어도 마찬가지입니다. ?|는 배열을 받아 키가 하나라도 있으면, ?&는 모두 있으면 참입니다.
JSONB 안의 필드에 외래 키나 NOT NULL 제약 조건을 걸 수 있나요?
직접은 안 됩니다. CHECK 제약 조건으로 필드를 검사할 수는 있지만(CHECK (data ? 'email')), 외래 키에는 실제 컬럼이 필요합니다. 모든 행에 있고 다른 테이블이 참조하는 필드는 일반 컬럼에 두세요.