zipfile
ZIP 압축 파일 내의 텍스트를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
zipfile [offset=INT] [limit=INT] PATH ENTRY
옵션
offset=INT- 건너뛸 레코드 수
limit=INT- 가져올 최대 레코드 수
대상
PATH- ZIP 파일 경로
ENTRY- ZIP 파일 내의 엔트리(파일) 경로
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| line | 문자열 | 텍스트 파일에서 읽은 원본 줄 |
| _file | 문자열 | ZIP 파일 경로 |
| _entry | 문자열 | ZIP 엔트리 경로 |
| _time | 날짜 | 타임스탬프 (현재 시각) |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 14002 | - | 파일 경로 또는 엔트리 경로가 지정되지 않은 경우 |
| 14000 | - | 파일이 존재하지 않거나 읽을 수 없는 경우 |
| 14001 | - | 상위 디렉터리가 존재하지 않거나 읽을 수 없는 경우 |
| 14003 | - | 파일 접근이 거부된 경우 |
설명
zipfile 명령어는 ZIP으로 압축된 텍스트 파일에서 데이터를 조회합니다. 지정된 엔트리의 각 줄을 line 필드에 담아 레코드로 반환합니다. PATH에 와일드카드(*)를 사용하면 여러 ZIP 파일을 순서대로 처리합니다.
이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.
사용 예
각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.
-
ZIP 파일 내의 텍스트 조회
zipfile /opt/logpresso/data/logs.zip access.loglogs.zip파일 내의access.log엔트리를 줄 단위로 조회합니다. -
건수를 제한하여 조회
zipfile limit=100 /opt/logpresso/data/logs.zip error.logerror.log엔트리에서 최대 100건을 조회합니다.
호환성
zipfile 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.