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 설정에 포함되어 있다고 가정합니다.

  1. JSON 파일 조회

    jsonfile /opt/logpresso/data/events.json
    

    줄 단위 JSON 파일에서 전체 데이터를 조회합니다.

  2. 최대 건수를 지정하여 조회

    jsonfile offset=100 limit=50 /opt/logpresso/data/events.json
    

    처음 100건을 건너뛰고 50건의 레코드를 조회합니다.

  3. overlay 모드로 조회

    jsonfile overlay=t /opt/logpresso/data/events.json
    

    파서를 추가로 적용할 때 원본 데이터를 유지하면서 파싱된 키-값을 덮어씁니다.

호환성

jsonfile 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.