ReplaceText 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
FlowFile 내용에서 일부 텍스트 값(정규식/regex 또는 리터럴 값)을 검색하고 일치하는 내용 섹션을 일부 대체 값으로 대체하여 FlowFile 의 내용을 업데이트합니다. 또한 FlowFile 의 내용에 텍스트를 추가하거나 앞에 추가하는 데 사용할 수도 있습니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
---|---|
문자 세트 |
파일이 인코딩되는 문자 세트입니다 |
평가 모드 |
‘Replacement Strategy’를 각 라인에 대해 개별적으로 실행하거나(라인별), 전체 파일을 메모리에 버퍼링한 후(전체 텍스트) 실행합니다. |
라인별 평가 모드 |
FlowFile 내 모든 라인에 대해 ‘Replacement Strategy’를 각 라인별로(라인 단위) 적용합니다. 첫 번째 라인(헤더)만, 마지막 라인(푸터)만, 첫 번째 라인(헤더)을 제외하거나 마지막 라인(푸터)을 제외하고 적용합니다. |
Maximum Buffer Size |
대체를 적용하기 위해 버퍼링할 최대 데이터 양(평가 모드에 따라 파일당 또는 라인당)을 지정합니다. ‘전체 텍스트’(평가 모드에서)를 선택하고 FlowFile 이 이 값보다 크면 FlowFile 은 ‘실패’로 라우팅됩니다. ‘라인 단위’모드에서 한 라인이 이 값보다 크면 FlowFile 은 ‘실패’로 라우팅됩니다. 기본값은 1 MB 이며, 주로’전체 텍스트’모드에 제공됩니다. ‘라인 단위’ 모드에서는 8 KB 또는 16 KB 같은 값이 제안됩니다. <Replacement Strategy> 속성이 Append, Prepend, Always Replace 중 하나로 설정된 경우 이 값은 무시됩니다. |
정규식 |
FlowFile 내용에서 검색할 검색 값입니다. ‘Literal Replace’ 및 ‘Regex Replace’ 일치 전략에만 사용됩니다 |
Replacement Strategy |
FlowFile 의 텍스트 내용 내에서 무엇을 어떻게 교체할지에 대한 전략입니다. |
대체 값 |
‘Replacement Strategy’를 사용하여 삽입할 값입니다. 정규식 캡처 그룹에 대한 “Regex 바꾸기” 역참조는 지원되지만 정규식에 존재하지 않는 캡처 그룹을 참조하는 역참조는 리터럴 값으로 처리됩니다. 역참조는 ‘$1’, ‘$2’ 등의 표현식을 사용하여 참조할 수도 있습니다. 이러한 변수는 “표준” 특성 이름이 아니므로 작은따옴표를 포함해야 합니다(특성 이름은 숫자, 문자 및 _만 포함된 경우를 제외하고 따옴표로 묶어야 합니다). |
뒤에 추가할 텍스트 |
평가 모드 속성의 구성된 값에 따라 FlowFile 또는 각 라인의 끝에 추가할 텍스트입니다 |
앞에 추가할 텍스트 |
평가 모드 속성의 구성된 값에 따라 FlowFile 또는 각 라인의 시작 부분에 추가할 텍스트입니다 |
관계¶
이름 |
설명 |
---|---|
실패 |
업데이트할 수 없는 FlowFiles 은 이 관계로 라우팅됩니다. |
성공 |
성공적으로 처리된 FlowFiles 은 이 관계로 전송됩니다. 여기에는 텍스트가 교체된 FlowFiles 및 그렇지 않은 FlowFile이 모두 포함됩니다. |
사용 사례¶
FlowFile 의 모든 라인 끝에 텍스트를 추가합니다 |
FlowFile 에서 모든 라인의 시작 부분에 텍스트를 추가합니다 |
FlowFile 에서 리터럴 문자열의 모든 항목을 다른 값으로 바꿉니다 |
FlowFile 에서 리터럴 문자열의 모든 발생을 변환합니다 |
FlowFile 의 내용을 특정 텍스트로 완전히 바꿉니다 |