jq 플레이그라운드
| 필터 | 설명 |
|---|---|
| 전체 문서를 보기 좋게 출력 | |
| 배열의 모든 요소를 순회 | |
| 경로로 중첩된 값 읽기 | |
| 조건에 맞는 요소만 유지 | |
| 배열의 모든 요소를 변환 | |
| 객체의 키 나열 | |
| 객체를 키/값 쌍으로 변환 | |
| 필드별로 요소를 그룹화하고 개수 세기 | |
| 필드별로 배열 정렬 | |
| 배열 요소 개수 세기 | |
| 행을 CSV로 서식 지정(원시 출력 활성화) | |
| 문자열을 Base64로 인코딩(원시 출력 활성화) | |
| 모든 숫자 값의 경로 나열 | |
| 모든 숫자를 재귀적으로 수집 | |
| reduce로 값 합산 | |
| Null 입력으로 모든 입력 읽기(여러 JSON 문서를 시도해 보세요) |
기술적 세부 정보
jq 플레이그라운드 작동 방식
이 도구가 하는 일
jq 플레이그라운드는 입력하는 동안 실제 jq 필터를 JSON에 실행합니다. jq 1.8은 WebAssembly로 컴파일되어 Web Worker에서 실행되므로 오류 메시지를 포함해 명령줄 도구와 정확히 같은 결과가 나옵니다. JSON을 붙여넣고 .users[] | select(.age > 30) | .name 같은 필터를 작성하면 잠시 후 출력이 업데이트됩니다. 옵션은 jq 플래그에 직접 대응합니다. 원시 출력(-r), 압축(-c), slurp(-s), null 입력(-n), 키 정렬(-S), 탭 들여쓰기(--tab), 이름이 있는 --arg 변수입니다.
일반적인 사용 사례
개발자는 셸 스크립트, CI 파이프라인, Kubernetes 또는 AWS CLI 한 줄 명령에 넣기 전에 필터를 프로토타이핑하고, 큰 API 응답과 로그 줄을 탐색하고, @csv로 JSON을 CSV로 변환하고, map, group_by, reduce로 페이로드를 재구성하고, 클릭할 수 있는 예제가 담긴 내장 치트시트로 jq를 배우는 데 사용합니다.
입력, 출력 및 플래그
입력은 단일 JSON 문서이거나 NDJSON처럼 이어 붙인 여러 문서일 수 있습니다. Slurp를 사용하면 하나의 배열로 감싸지고, Null 입력을 사용하면 input과 inputs로 직접 읽습니다. 각 결과는 한 줄씩 출력됩니다. 원시 출력은 문자열을 따옴표 없이 출력하며, @csv, @tsv, @base64, @uri 출력에 필요합니다. --arg로 전달한 값은 필터 안에서 $name으로 사용할 수 있으며 항상 문자열입니다.
함정과 제한 사항
입력은 5 MB로 제한되며, 무한 필터가 페이지를 멈추지 않도록 실행은 10초 후 중지됩니다. 숫자는 jq의 배정밀도 의미 체계로 처리되므로 2^53보다 큰 정수는 정밀도를 잃을 수 있습니다. 여기서는 셸 따옴표가 필요 없으며, 터미널에서는 필터를 작은따옴표로 감싸세요. 이 플레이그라운드는 jq 모듈, 파일에서의 import, 환경 변수를 지원하지 않습니다.