JSON Path Tester: JSONPath 표현식으로 JSON 데이터 쿼리하기

2026년 3월 31일 · 12분 읽기

JSONPath 이해하기

JSONPath는 JSON 데이터 구조를 위해 특별히 설계된 쿼리 언어입니다. XML용 XPath나 데이터베이스용 SQL 쿼리가 작동하는 방식과 유사하게, 복잡한 JSON 문서를 정확하게 탐색할 수 있는 강력한 검색 도구라고 생각하면 됩니다.

JSONPath를 사용하면 복잡한 루프나 재귀 함수를 작성하지 않고도 대용량 데이터셋에서 필요한 것을 정확히 찾기 위한 상세한 쿼리를 실행할 수 있습니다. 예를 들어, 고객, 주문, 제품에 대한 여러 계층의 데이터가 포함된 대용량 JSON 파일을 다루는 경우, JSONPath는 각 레벨을 수동으로 반복하지 않고도 $100 이상의 주문을 한 모든 고객의 이름을 직접 추출할 수 있습니다.

JSONPath의 진정한 힘은 중첩된 JSON 구조나 복잡한 JSON 응답을 반환하는 API를 다룰 때 명확해집니다. 데이터 처리를 극적으로 단순화하여 단일 표현식으로 필요한 정보를 직접 가져올 수 있습니다. 쇼핑 애플리케이션에서 가격을 업데이트하거나 재고 수준을 확인하기 위해 특정 카테고리에 나열된 모든 항목을 빠르게 조회해야 할 수 있습니다. JSONPath는 이 데이터를 즉시 찾아내는 데 도움을 줍니다.

개발자에게 JSONPath가 중요한 이유

현대 애플리케이션은 JSON 형식으로 데이터를 자주 교환합니다. REST API를 사용하든, 구성 파일을 처리하든, 데이터베이스 응답을 처리하든 JSON은 어디에나 있습니다. JSONPath는 몇 가지 주요 이점을 제공합니다:

• 코드 복잡성 감소: 수십 줄의 중첩 루프를 단일 표현식으로 대체
• 가독성 향상: JSONPath 표현식은 자체 문서화되며 절차적 코드보다 이해하기 쉬움
• 유지보수성 향상: 데이터 구조 변경 시 JSONPath 쿼리에 대한 최소한의 업데이트만 필요
• 크로스 언어 지원: JavaScript, Python, Java, PHP 및 대부분의 다른 언어에 대한 JSONPath 구현 존재
• 빠른 개발: 전체 애플리케이션을 작성하지 않고도 쿼리를 즉시 테스트하고 검증

JSON Path Tester 시작하기

JSON Path Tester는 개발자가 프로덕션 코드에 구현하기 전에 샘플 JSON 데이터에 대해 JSONPath 표현식을 검증하는 데 도움이 되는 필수 도구입니다. 이러한 테스터는 즉각적인 피드백을 제공하여 표현식이 추출할 데이터를 정확히 보여줍니다.

JSON Path Tester를 사용하는 것은 간단합니다. 일반적으로 JSON 데이터를 한 패널에 붙여넣고, JSONPath 표현식을 다른 패널에 입력하면 즉시 결과를 볼 수 있습니다. 이러한 대화형 접근 방식은 수많은 디버깅 시간을 절약하고 다양한 쿼리 패턴을 실험할 수 있게 해줍니다.

좋은 JSON Path Tester의 주요 기능

JSON Path Tester를 선택할 때 다음과 같은 필수 기능을 찾아보세요:

• 실시간 검증: 표현식을 입력하는 동안 즉각적인 피드백
• 구문 강조: 가독성 향상을 위한 색상 코딩된 JSON 및 JSONPath
• 오류 메시지: 표현식이 실패할 때 명확한 설명
• 다중 출력 형식: JSON, 배열 또는 형식화된 텍스트로 결과 보기
• 샘플 데이터: 학습에 도움이 되는 사전 로드된 예제
• 표현식 기록: 일반적인 쿼리 저장 및 재사용

JSONPath 구문 및 연산자

JSONPath는 JSON 구조를 탐색하기 위해 특정 구문을 사용합니다. 효과적인 쿼리를 작성하려면 이러한 연산자를 이해하는 것이 중요합니다. 구문은 JavaScript 객체 표기법과 XPath의 개념을 차용하여 직관적으로 설계되었습니다.

기본 연산자

필터 표현식

필터 표현식은 JSONPath의 가장 강력한 기능 중 하나입니다. SQL의 WHERE 절과 유사하게 조건에 따라 요소를 선택할 수 있습니다. 필터는 @ 기호를 사용하여 평가 중인 현재 요소를 참조합니다.

필터의 일반적인 비교 연산자는 다음과 같습니다:

• == - 같음
• != - 같지 않음
• < - 작음
• <= - 작거나 같음
• > - 큼
• >= - 크거나 같음
• =~ - 정규 표현식과 일치

일반적인 JSONPath 표현식

실용적인 예제와 함께 가장 자주 사용되는 JSONPath 표현식을 살펴보겠습니다. 이러한 패턴은 JSON 데이터를 다룰 때 접하게 될 대부분의 실제 시나리오를 다룹니다.

루트 및 자식 요소 선택

가장 간단한 JSONPath 표현식은 특정 속성으로 직접 이동합니다:

// 루트 선택
$

// 직접 자식 속성 선택
$.store

// 중첩된 속성 선택
$.store.book

// 대괄호 표기법 사용 (공백이나 특수 문자가 있는 속성에 유용)
$['store']['book']

배열 다루기

배열은 JSON에서 일반적이며, JSONPath는 요소에 액세스하는 여러 방법을 제공합니다:

// 첫 번째 요소
$.store.book[0]

// 마지막 요소
$.store.book[-1]

// 여러 특정 요소
$.store.book[0,2,4]

// 요소 범위 (슬라이스)
$.store.book[0:3]  // 요소 0, 1, 2

// 인덱스 2부터 모든 요소
$.store.book[2:]

// 인덱스 3까지 모든 요소
$.store.book[:3]

// 하나 걸러 하나씩
$.store.book[::2]

와일드카드 사용

와일드카드는 정확한 이름을 모르고도 여러 요소를 선택하는 데 도움이 됩니다:

// store의 모든 직접 자식
$.store.*

// 모든 책 (배열 위치와 관계없이)
$.store.book[*]

// 모든 책의 모든 속성
$.store.book[*].*

재귀 하강

재귀 하강 연산자 (..)는 JSON 구조의 모든 레벨을 검색합니다:

// 문서 어디에서나 모든 'price' 속성 찾기
$..price

// 모든 'author' 속성 찾기
$..author

// 모든 배열의 모든 요소 찾기
$..[*]

JSONPath 표현식 테스트하기

배포 전에 JSONPath 표현식을 철저히 테스트하면 런타임 오류를 방지하고 올바른 데이터를 추출하고 있는지 확인할 수 있습니다. 체계적인 테스트 접근 방식은 디버깅 시간을 절약하고 코드 신뢰성을 향상시킵니다.

단계별 테스트 프로세스

1. JSON 검증: JSON Validator를 사용하여 데이터 구조가 올바른지 확인
2. 간단하게 시작: 기본 표현식으로 시작하여 점진적으로 복잡성 추가
3. 엣지 케이스 테스트: 빈 배열, null 값 및 누락된 속성으로 동작 확인
4. 배열 경계 확인: 인덱스 기반 쿼리가 배열 길이를 초과하지 않는지 확인
5. 필터 로직 검증: 다양한 데이터 값으로 필터를 테스트하여 예상대로 작동하는지 확인
6. 결과 비교: 수동으로 추출한 데이터와 출력을 교차 확인

일반적인 테스트 시나리오

JSONPath 표현식을 테스트할 때 다음 시나리오를 고려하세요:

• 빈 결과: 쿼리와 일치하는 요소가 없을 때 어떻게 되나요?
• 단일 대 다중 일치: 코드가 두 경우를 모두 올바르게 처리하나요?
• 타입 불일치: 숫자로 예상한 속성이 실제로 문자열이면 어떻게 되나요?
• 누락된 속성: 선택적 필드가 없을 때 표현식이 어떻게 동작하나요?
• 깊게 중첩된 데이터: 쿼리가 모든 중첩 레벨에서 작동하나요?

JSON Path Tester를 사용한 실용적인 예제

샘플 JSON 데이터셋을 사용하여 실제 예제를 살펴보겠습니다. 이러한 예제는 JSONPath가 일반적인 데이터 추출 문제를 어떻게 해결하는지 보여줍니다.

예제 1: 전자상거래 제품 카탈로그

온라인 상점을 나타내는 다음 JSON 구조를 고려하세요:

{
  "store": {
    "books": [
      {
        "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99,
        "inStock": true
      },
      {
        "category": "fiction",
        "author": "J.R.R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99,
        "inStock": false
      },
      {
        "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "isbn": "0-486-27557-4",
        "price": 8.95,
        "inStock": true
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95,
      "inStock": true
    }
  }
}

이 데이터에 대한 유용한 쿼리는 다음과 같습니다:

예제 2: API 응답 처리

API 응답을 다룰 때 중첩된 구조에서 특정 필드를 추출해야 하는 경우가 많습니다. 다음 사용자 데이터 응답을 고려하세요:

{
  "users": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "[email protected]",
      "address": {
        "street": "123 Main St",
        "city": "Boston",
        "state": "MA",
        "zip": "02101"
      },
      "orders": [
        {"id": 101, "total": 45.99, "status": "shipped"},
        {"id": 102, "total": 23.50, "status": "pending"}
      ]
    },
    {
      "id": 2,
      "name": "Jane Smith",
      "email": "[email protected]",
      "address": {
        "street": "456 Oak Ave",
        "city": "Seattle",
        "state": "WA",
        "zip": "98101"
      },
      "orders": [
        {"id": 103, "total": 89.99, "status": "delivered"}
      ]
    }
  ]
}

이 API 응답에 대한 유용한 쿼리:

// 모든 사용자 이메일
$.users[*].email

// 모든 도시
$.users[*].address.city

// 모든 사용자의 모든 주문 ID
$..orders[*].id

// 상태가 'pending'인 주문
$..orders[?(@.status == 'pending')]

// 매사추세츠 출신 사용자
$.users[?(@.address.state == 'MA')]

// 모든 주문의 총 금액
$..orders[*].total