jq 플레이그라운드

사용 방법

1. 왼쪽 JSON 입력 패널에 JSON을 붙여넣거나 입력합니다(샘플 users 데이터가 미리 로드되어 있음).
2. jq 필터 입력란에 식을 작성하거나 아래의 예시 pill을 클릭하세요.
3. 결과는 결과 영역에 JSON 구문 강조 표시와 함께 렌더링됩니다.
4. 복사 버튼으로 포맷된 출력을 클립보드로 가져갈 수 있습니다.

jq 치트시트

• . — 항등 필터, 입력을 그대로 출력
• .field — 속성 값 추출
• .field? — 선택적 추출(필드 누락 시 오류 없음)
• .[] — 배열 또는 객체 값 순회
• .[start:end] — 배열 슬라이스
• f | g — f의 출력을 g로 파이프
• f, g — f와 g를 모두 출력
• select(cond) — cond가 참인 값만 유지
• map(f) — 배열의 각 요소에 f 적용
• group_by(.k) — key로 그룹화
• sort_by(.k) — key로 정렬
• length, keys, values, type, has(k) — 인트로스펙션
• add, min, max, unique — 집계
• tonumber, tostring, ascii_downcase, split(”/”) — 변환
• reduce, foreach, def — 제어 흐름 및 사용자 함수

주요 사용 사례

jq는 shell 파이프라인에서 JSON을 다루는 표준 도구입니다: curl로 받은 API 응답, Kubernetes 매니페스트, CI/CD 로그, AWS CLI 출력, 인프라 코드 상태, 데이터 내보내기. 이 Playground는 작은 샘플로 필터를 시제품화한 뒤, 표현식을 그대로 jq -r ’…’에 사용해 큰 파일을 처리하는 용도입니다.

자주 쓰는 레시피: .items | map({id, name})로 API 리스트 응답을 평탄화, group_by(.tag) | map({tag: .[0].tag, count: length})로 이벤트를 tag별로 버킷화, [.[] | .duration_ms] | add / length로 숫자 필드의 평균 계산.