JSON 쿼리
JSONPath로 JSON 데이터에서 원하는 값만 뽑아냅니다.
사용 예시
큰 API 응답에서 필요한 필드만 뽑아내기
응답 JSON 전체를 뒤지지 않고, $.data.items[*].id 같은 경로로 필요한 값만 한 번에 골라낼 수 있습니다.
조건에 맞는 항목만 걸러내기
$.products[?(@.price<10000)]처럼 필터 조건을 써서, 가격이나 재고 같은 조건에 맞는 항목만 추려낼 수 있습니다.
중첩된 구조에서 특정 키를 한 번에 찾기
$..price처럼 재귀 탐색 문법을 쓰면, 깊이와 위치에 상관없이 문서 전체에서 같은 이름의 키를 전부 찾을 수 있습니다.
배열의 마지막 항목만 가져오기
$.orders[-1:]를 쓰면 계속 늘어나는 로그나 주문 배열에서, 전체 개수를 세지 않고도 가장 최근 항목만 바로 뽑아낼 수 있습니다.
여러 필드를 한 번에 골라내기
$.user['name','email','id']처럼 유니온 표현식을 쓰면, 크고 복잡한 사용자 레코드에서 딱 필요한 세 필드만 추려내고 나머지는 모두 건너뛸 수 있습니다.
처음 보는 API 응답의 구조 파악하기
한 번도 본 적 없는 응답에서 특정 필드가 얼마나 깊이 중첩되어 있는지 모르겠다면? $..필드명으로 먼저 위치를 찾은 다음, 정확한 경로로 좁혀가며 확인할 수 있습니다.
자주 묻는 질문
입력한 JSON과 표현식이 서버로 전송되나요?
아니요. 쿼리는 브라우저 안에서만 실행되며 입력한 내용이 서버로 전송되지 않습니다.
JSONPath 문법이 기억나지 않아요.
자주 쓰는 패턴은 이렇습니다: $는 전체 문서, .key는 특정 키, [*]는 배열의 모든 항목, [0]은 첫 번째 항목, [?(@.price<10)]는 조건에 맞는 항목만 걸러내기, $..key는 깊이에 상관없이 해당 이름의 키를 전부 찾기입니다.
결과가 비어 있어요. 왜 그런가요?
경로가 가리키는 데이터가 실제로 없거나, 표현식 문법이 잘못됐을 때 모두 빈 결과로 나타날 수 있습니다. 경로를 단계별로 짧게 줄여가며 어느 지점부터 비는지 확인해보세요.
쿼리 결과는 항상 배열인가요?
네. JSONPath는 일치하는 모든 값을 배열로 모아 반환합니다. 값이 하나만 일치해도 길이 1짜리 배열로 나옵니다.
이건 JSONPath인가요, JMESPath나 jq 문법인가요?
JSONPath이며, jsonpath-plus 라이브러리로 평가합니다. $, ., [*], [n], $..key 같은 표준 문법은 물론 필터 표현식([?(@.price<10)])이나 스크립트 표현식 같은 확장 기능도 지원하지만, jq나 JMESPath 쿼리 문법과는 호환되지 않습니다. 두 쪽은 서로 다른 연산자를 사용합니다.
배열을 두 가지 이상의 조건으로 필터링할 수 있나요?
네. 필터 표현식 안에서 &&나 ||로 조건을 조합할 수 있습니다. 예를 들어 $.products[?(@.price<100 && @.inStock==true)]는 가격이 저렴하면서 재고도 있는 항목만 매칭합니다.
경로에서 음수 인덱스나 슬라이스도 지원하나요?
네. [-1]은 마지막 요소를 가리키고, [1:3]이나 [-2:] 같은 슬라이스 문법도 파이썬과 동일하게 동작해서, 배열의 정확한 길이를 몰라도 원하는 범위의 항목을 바로 가져올 수 있습니다.