SplitText
SplitText
텍스트 파일을 최대 줄 수 또는 단편의 총 크기로 제한되는 줄 경계에서 여러 개의 더 작은 텍스트 파일로 나누는 프로세서예요. 헤더 줄도 분할마다 포함할 수 있어요.
출처: Snowflake 문서
본문
번들 (Bundle)
org.apache.nifi | nifi-standard-nar
설명 (Description)
텍스트 파일을 최대 줄 수 또는 단편의 총 크기로 제한되는 줄 경계에서 여러 개의 더 작은 텍스트 파일로 나눕니다. 각 출력 분할 파일에는 구성된 줄 수나 바이트 수를 초과하는 내용이 포함되지 않습니다. Line Split Count와 Maximum Fragment Size가 모두 지정되면 먼저 도달하는 제한에서 분할이 발생합니다. 단편의 첫 줄이 Maximum Fragment Size를 초과하면 해당 줄은 구성된 최대 크기 제한을 초과하는 단일 분할 파일로 출력됩니다. 이 구성 요소는 각 분할에 헤더 줄을 포함하도록 지정할 수도 있습니다. 헤더 줄은 헤더를 구성해야 하는 줄 수를 지정하거나, 읽은 줄과 일치시킬 헤더 마커를 사용해 계산할 수 있습니다. 그런 일치가 발생하면 해당 줄이 헤더로 처리됩니다. 헤더 마커 일치가 처음 실패하면 더 이상 일치를 수행하지 않고 나머지 데이터는 주어진 분할에 대한 일반 줄로 파싱됩니다. 헤더 계산 후 더 이상 데이터가 없으면 결과 분할은 헤더 줄만으로 구성됩니다.
태그 (Tags)
split, text
입력 요구사항 (Input Requirement)
REQUIRED
민감 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false
속성 (Properties)
| 속성 (Property) | 설명 (Description) |
|---|---|
| Header Line Count | 헤더의 일부로 간주해야 하는 줄 수입니다. 헤더 줄은 모든 분할 파일에 복제됩니다. |
| Header Line Marker Characters | 데이터파일 줄의 헤더 줄을 나타내는 첫 문자(들)입니다. Header Line Count가 0이 아니면 이 값은 무시됩니다. Header Line Marker Characters를 포함하지 않는 첫 줄과 그 이후의 모든 줄은 비헤더로 간주됩니다. |
| Line Split Count | 헤더 줄을 제외하고 각 분할 파일에 추가할 줄 수입니다. 값 0은 Maximum Fragment Size를 설정해야 하며, 줄 수는 분할 결정에 고려되지 않습니다. |
| Maximum Fragment Size | 헤더 줄을 포함한 각 분할 파일의 최대 크기입니다. 참고: 단일 줄이 이 속성(해당되는 경우 헤더 포함)을 초과하면 해당 줄은 이 Maximum Fragment Size 설정을 초과하는 자체 분할로 출력됩니다. |
| Remove Trailing Newlines | 각 분할 파일 끝에서 줄바꿈을 제거할지 여부입니다. 나중에 분할 파일을 병합하려면 false여야 합니다. 'true'로 설정되고 '빈 줄'만(즉, r과 n 문자만) 포함하는 FlowFile이 생성되면 해당 FlowFile은 내보내지지 않습니다. 단, 헤더 줄이 지정되면 결과 FlowFile은 헤더 줄로 구성되므로 결코 비지 않으며, 헤더 줄만 포함하는 FlowFile이 내보내질 수 있습니다. |
관계 (Relationships)
| 이름 (Name) | 설명 (Description) |
|---|---|
| failure | 어떤 이유로 파일을 분할할 수 없으면 원본 파일이 이 대상으로 라우팅되고 다른 곳으로는 아무것도 라우팅되지 않습니다. |
| original | 입력 파일이 하나 이상의 파일로 성공적으로 분할되면 원본 입력 파일이 이 대상으로 라우팅됩니다. |
| splits | 입력 파일이 하나 이상의 분할 파일로 성공적으로 분할되면 분할 파일이 이 대상으로 라우팅됩니다. |
쓰는 속성 (Writes attributes)
| 이름 (Name) | 설명 (Description) |
|---|---|
| text.line.count | 원본 FlowFile에서 이 FlowFile로 복사된 텍스트 줄 수입니다. |
| fragment.size | 원본 FlowFile에서 이 FlowFile로 복사된 바이트 수입니다. 각 분할 FlowFile에 복제되는 헤더가 해당되면 포함됩니다. |
| fragment.identifier | 같은 부모 FlowFile에서 만들어진 모든 분할 FlowFile은 이 속성에 대해 같은 무작위 생성 UUID를 갖습니다. |
| fragment.index | 단일 부모 FlowFile에서 생성된 분할 FlowFile의 순서를 나타내는 일련 번호입니다. |
| fragment.count | 부모 FlowFile에서 생성된 분할 FlowFile의 수입니다. |
| segment.original.filename | 부모 FlowFile의 파일 이름입니다. |
함께 보기 (See also)
- org.apache.nifi.processors.standard.MergeContent