jsonfile
줄 단위 JSON 파일에서 데이터를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
jsonfile [offset=INT] [limit=INT] [overlay={t|f}] PATH
옵션
offset=INT- 건너뛸 레코드 수
limit=INT- 가져올 최대 레코드 수
overlay={t|f}t지정 시 파서를 추가로 적용할 때 원본 데이터를 유지하면서 파싱된 키-값을 덮어씁니다.f또는 미지정 시 원본 대신 파싱된 키-값만 출력합니다.
대상
PATH- JSON 파일 경로. 각 줄이 하나의 JSON 객체인 텍스트 파일이어야 합니다. 와일드카드(
*)를 사용할 수 있으며,.gz확장자의 파일은 gzip 압축을 자동으로 해제합니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| (JSON 키) | 자동 | JSON 객체의 키-값 쌍에서 자동 매핑된 필드 |
| _file | 문자열 | 원본 파일 이름 |
| _time | 날짜 | JSON에서 파싱된 타임스탬프 또는 파일 수정 시각 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 10902 | - | 파일 경로가 지정되지 않은 경우 |
| 10900 | - | 파일이 존재하지 않거나 읽을 수 없는 경우 |
| 10901 | - | 상위 디렉터리가 존재하지 않거나 읽을 수 없는 경우 |
| 10903 | - | 파일 접근이 거부된 경우 |
설명
jsonfile 명령어는 CR LF 또는 LF로 구분되는 줄 단위로 JSON을 포함하는 텍스트 파일에서 데이터를 조회합니다. 각 줄의 JSON 객체가 하나의 레코드로 매핑되며, JSON 키-값은 자동으로 로그프레소 타입으로 변환됩니다.
BOM(Byte Order Mark)이 포함된 파일을 자동으로 인식합니다.
이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.
사용 예
각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.
-
JSON 파일 조회
jsonfile /opt/logpresso/data/events.json줄 단위 JSON 파일에서 전체 데이터를 조회합니다.
-
최대 건수를 지정하여 조회
jsonfile offset=100 limit=50 /opt/logpresso/data/events.json처음 100건을 건너뛰고 50건의 레코드를 조회합니다.
-
overlay 모드로 조회
jsonfile overlay=t /opt/logpresso/data/events.json파서를 추가로 적용할 때 원본 데이터를 유지하면서 파싱된 키-값을 덮어씁니다.
호환성
jsonfile 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.