xmlfile
XML 파일에서 데이터를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
xmlfile [cs=STR] [xpath=STR] PATH
옵션
cs=STR- XML 파일의 문자 인코딩 (기본값:
utf-8).charset옵션으로도 지정할 수 있습니다. xpath=STR- XML 노드를 선택하는 XPath 표현식. 미지정 시 XML 전체를 하나의 레코드로 반환합니다.
대상
PATH- XML 파일 경로. 와일드카드(
*)를 사용할 수 있습니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| (XML 요소) | 자동 | XML 요소의 이름과 값으로 매핑된 필드 |
| _file | 문자열 | 원본 파일 이름 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 13100 | - | 파일 경로가 지정되지 않은 경우 |
| 13102 | - | 파일이 존재하지 않거나 읽을 수 없는 경우 |
| 13101 | - | 상위 디렉터리가 존재하지 않거나 읽을 수 없는 경우 |
| 13103 | - | XPath 표현식을 컴파일할 수 없는 경우 |
| 13104 | - | XML 파일이 10MB 이상인 경우 |
| 13105 | - | 파일 접근이 거부된 경우 |
설명
xmlfile 명령어는 XML 파일을 파싱하여 각 요소를 레코드로 반환합니다. xpath 옵션을 사용하면 특정 노드만 선택하여 조회할 수 있습니다.
10MB 이상의 XML 파일은 처리할 수 없습니다. 와일드카드로 여러 파일을 지정한 경우, 10MB 이상이거나 오류가 발생한 파일은 경고 로그를 남기고 건너뜁니다.
BOM(Byte Order Mark)이 포함된 파일을 자동으로 인식합니다.
이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.
사용 예
각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.
-
XML 파일 전체 조회
xmlfile /opt/logpresso/data/config.xmlXML 파일의 전체 데이터를 조회합니다.
-
XPath로 특정 노드 선택
xmlfile xpath="//item" /opt/logpresso/data/catalog.xmlXPath 표현식을 사용하여 모든
item노드를 조회합니다.
호환성
xmlfile 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.