ReplaceText 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

FlowFile 내용에서 일부 텍스트 값(정규식/regex 또는 리터럴 값)을 검색하고 일치하는 내용 섹션을 일부 대체 값으로 대체하여 FlowFile 의 내용을 업데이트합니다. 또한 FlowFile 의 내용에 텍스트를 추가하거나 앞에 추가하는 데 사용할 수도 있습니다.

태그

변경, 수정, Regex, 정규식, 바꾸기, 텍스트, 업데이트

입력 요구 사항

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 의 내용을 특정 텍스트로 완전히 바꿉니다