xlsxfile

로컬 파일시스템의 XLSX 파일을 읽어 각 행을 레코드로 출력합니다. 여러 시트를 포함하는 파일에서 특정 시트를 지정할 수 있습니다.

명령어 속성

항목설명
명령어 유형드라이버 쿼리
필요 권한클러스터 관리자
라이선스 사용량집계함
병렬 실행미지원
분산 실행미지원

문법

xlsxfile [skip=LONG] [offset=LONG] [limit=LONG] [sheet=STR] PATH

옵션

skip=LONG
처음에 건너뛸 행 수. 헤더 행 등 처음 몇 행을 제외하고 읽을 때 사용합니다. (기본값: 0)
offset=LONG
건너뛸 레코드 수 (기본값: 0)
limit=LONG
읽을 최대 레코드 수. 지정하지 않으면 모든 행을 읽습니다.
sheet=STR
읽을 시트 이름. 지정하지 않으면 모든 시트를 순서대로 읽습니다.

대상

PATH
XLSX 파일의 경로. 와일드카드(*)를 사용하여 여러 파일을 지정할 수 있습니다.

출력 필드

각 셀의 컬럼 인덱스(1부터 시작)를 기반으로 필드명(col1, col2, ...)을 할당합니다. 첫 번째 행이 헤더인 경우 skip=1로 첫 행을 건너뛰어야 합니다.

필드타입설명
col1문자열첫 번째 컬럼 값
col2문자열두 번째 컬럼 값
...문자열이후 컬럼 값
_sheet문자열해당 행이 속한 시트 이름
_file문자열원본 파일 이름

오류 코드

파싱 오류
오류 코드메시지설명
13000[file]이 존재하지 않거나 읽을 수 없습니다.지정한 XLSX 파일이 존재하지 않거나 읽을 수 없는 경우
13001[file]의 상위 디렉터리가 존재하지 않거나 읽을 수 없습니다.파일의 상위 디렉터리에 접근할 수 없는 경우
13002파일 경로를 입력하십시오.파일 경로를 지정하지 않은 경우
13003xlsxfile 명령어로 조회할 [file]의 접근이 거부되었습니다.파일 경로 접근이 보안 정책에 의해 거부된 경우
런타임 오류

해당 사항 없음

설명

xlsxfile 명령어는 로컬 파일시스템의 XLSX 파일을 읽어 각 행을 레코드로 변환하여 출력합니다. sheet 옵션을 지정하면 해당 시트만 읽고, 지정하지 않으면 모든 시트를 순서대로 읽습니다.

파일 경로에 쿼리 매개변수(${})를 사용할 수 있습니다.

이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.

사용 예

각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.

  1. XLSX 파일 읽기

    xlsxfile /data/report.xlsx

    /data/report.xlsx 파일의 모든 시트를 읽어 각 행을 레코드로 출력합니다.

  2. 특정 시트만 읽기

    xlsxfile sheet=Sheet1 /data/report.xlsx

    Sheet1 시트의 내용만 읽습니다.

  3. 헤더 행을 건너뛰고 읽기

    xlsxfile skip=1 /data/report.xlsx

    첫 번째 행(헤더)을 건너뛰고 데이터 행부터 읽습니다.

  4. 읽을 레코드 수를 제한하여 읽기

    xlsxfile limit=100 /data/large_report.xlsx

    처음 100개 행만 읽습니다.

호환성

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