ExcelReader
ExcelReader
Microsoft Excel 문서를 파싱해 각 시트의 각 행을 별도의 레코드로 반환하는 OpenFlow 컨트롤러 서비스예요.
출처: 문서
본문
기능 — 일반 공개(Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 지역의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용 지역의 모든 계정에서 사용할 수 있어요.
설명 (Description)
Microsoft Excel 문서를 파싱해 각 시트의 각 행을 별도의 레코드로 반환해요. 이 리더는 모든 필수 시트에서 스키마를 추론하거나 값을 해석하기 위한 명시적 스키마를 제공할 수 있어요. 자세한 문서는 Controller Service의 Usage를 참고하세요. 이 리더는 비밀번호로 보호된 .xlsx(XSSF 2007 OOXML 파일 형식)와 기존 .xls(HSSF'97(-2007) 파일 형식) Excel 문서를 모두 처리할 수 있어요.
태그 (Tags)
cell, excel, parse, reader, record, row, spreadsheet, values, xls, xlsx
속성 (Properties)
아래 목록에서 필수 속성은 별표(*)로 표시돼요. 그 외 속성은 선택 사항으로 간주돼요. 표에는 기본값과 해당 속성이 NiFi Expression Language를 지원하는지 여부도 함께 표시돼요.
| 표시 이름 (Display Name) | API 이름 (API Name) | 기본값 (Default Value) | 허용 값 (Allowable Values) | 설명 (Description) |
|---|---|---|---|---|
| Date Format | Date Format | Date 필드를 읽거나 쓸 때 사용할 형식을 지정해요. 지정하지 않으면 Date 필드는 epoch(1970년 1월 1일 GMT 자정) 이후의 밀리초 수로 간주돼요. 지정하면 값은 Java java.time.format.DateTimeFormatter 형식과 일치해야 해요 (예: 두 자리 월, 두 자리 일, 네 자리 연도를 '/'로 구분한 MM/dd/yyyy, 예: 01/01/2017). | ||
| Input File Type * | Input File Type | XLSX | XLS, XLSX | Excel 입력 파일의 유형을 지정해요. |
| Password * | Password | 비밀번호로 보호된 Excel 스프레드시트의 비밀번호예요. | ||
| Protection Type * | Protection Type | UNPROTECTED | Unprotected, Password Protected | Excel 스프레드시트가 비밀번호로 보호되는지 여부를 지정해요. |
| Required Sheets | Required Sheets | Excel 문서에서 행을 추출해야 하는 시트 이름의 쉼표로 구분된 목록이에요. 이 속성을 비워 두면 Excel 문서의 모든 시트에서 모든 행이 추출돼요. 이름 목록은 대소문자를 구분해요. 이 값에 지정되지 않은 시트는 무시돼요. 지정된 시트를 찾을 수 없으면 예외가 던져져요. | ||
| Row Evaluation Strategy * | Row Evaluation Strategy | STANDARD | Standard, All Rows | 시작 행 이후의 몇 행을 스키마 결정에 사용할지 선택하는 전략이에요. |
| Schema Access Strategy * | Schema Access Strategy | Use Starting Row | Use 'Schema Name' Property, Use 'Schema Text' Property, Schema Reference Reader, Use Starting Row, Infer Schema | 데이터를 해석하는 데 사용할 스키마를 얻는 방법을 지정해요. |
| Schema Branch | Schema Branch | 스키마 레지스트리 속성에서 스키마를 조회할 때 사용할 브랜치 이름을 지정해요. 선택한 스키마 레지스트리가 브랜치를 지원하지 않으면 이 값은 무시돼요. | ||
| Schema Name | Schema Name | ${schema.name} | 스키마 레지스트리 속성에서 조회할 스키마의 이름을 지정해요. | |
| Schema Reference Reader * | Schema Reference Reader | 스키마 참조 식별자(Schema Reference Identifier)를 결정하기 위해 FlowFile 속성이나 콘텐츠를 읽는 역할을 담당하는 서비스 구현이에요. | ||
| Schema Registry | Schema Registry | 스키마 레지스트리에 사용할 컨트롤러 서비스를 지정해요. | ||
| Schema Text | Schema Text | ${avro.schema} | Avro 형식 스키마의 텍스트예요. | |
| Schema Version | Schema Version | 스키마 레지스트리에서 조회할 스키마의 버전을 지정해요. 지정하지 않으면 최신 버전의 스키마를 가져와요. | ||
| Starting Row * | Starting Row | 1 | 처리를 시작할 첫 행의 행 번호예요 (1부터 시작). 워크시트 상단의 데이터셋에 속하지 않는 데이터 행을 건너뛰는 데 사용해요. 'Use Starting Row' 전략을 사용할 때 이 행이 열 헤더 행이어야 해요. | |
| Time Format | Time Format | Time 필드를 읽거나 쓸 때 사용할 형식을 지정해요. 지정하지 않으면 Time 필드는 epoch(1970년 1월 1일 GMT 자정) 이후의 밀리초 수로 간주돼요. 지정하면 값은 Java java.time.format.DateTimeFormatter 형식과 일치해야 해요 (예: 24시간 형식의 두 자리 시, 두 자리 분, 두 자리 초를 ':'로 구분한 HH:mm:ss, 예: 18:04:15). | ||
| Timestamp Format | Timestamp Format | Timestamp 필드를 읽거나 쓸 때 사용할 형식을 지정해요. 지정하지 않으면 Timestamp 필드는 epoch(1970년 1월 1일 GMT 자정) 이후의 밀리초 수로 간주돼요. 지정하면 값은 Java java.time.format.DateTimeFormatter 형식과 일치해야 해요 (예: 두 자리 월, 두 자리 일, 네 자리 연도를 '/'로 구분하고 24시간 형식의 두 자리 시, 두 자리 분, 두 자리 초를 ':'로 구분한 MM/dd/yyyy HH:mm:ss, 예: 01/01/2017 18:04:15). |
상태 관리 (State management)
이 컴포넌트는 상태를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되지 않아요.
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.