ConvertRecord 2025.5.31.15¶

번들¶

org.apache.nifi | nifi-standard-nar

설명¶

구성된 Record Reader 및 레코드 쓰기 컨트롤러 서비스를 사용하여 한 데이터 형식에서 다른 데이터 형식으로 레코드를 변환합니다. 리더와 작성기는 “일치하는” 스키마로 구성해야 합니다. 즉, 스키마는 필드 이름이 같아야 합니다. 필드 값을 한 유형에서 다른 유형으로 강제 변환할 수 있는 경우 필드의 유형이 동일할 필요는 없습니다. 예를 들어, 입력 스키마에 double 타입의 “balance”라는 필드가 있는 경우 출력 스키마에는 문자열, double 또는 float 타입의 “balance”라는 필드가 있을 수 있습니다. 입력에 있는 필드가 출력에 없는 경우 해당 필드는 출력에서 제외됩니다. 출력 스키마에 지정되어 있지만 입력 데이터/스키마에 없는 필드가 있는 경우 작성기에 따라 해당 필드는 출력에 존재하지 않거나 null 값을 갖습니다.

태그¶

avro, convert, csv, freeform, generic, json, log, logs, record, schema, text

입력 요구 사항¶

REQUIRED

민감한 동적 속성 지원¶

false

속성¶

속성	설명
제로 레코드 FlowFiles 포함	수신 FlowFile 을 변환할 때 변환 결과 데이터가 없는 경우 이 속성은 FlowFile 을 해당 관계로 보낼지 여부를 지정합니다
Record Reader	수신 데이터를 읽는 데 사용할 컨트롤러 서비스를 지정합니다
Record Writer	레코드 작성에 사용할 컨트롤러 서비스를 지정합니다

관계¶

이름	설명
실패	FlowFile 을 구성된 입력 형식에서 구성된 출력 형식으로 변환할 수 없는 경우 변경되지 않은 FlowFile 은 이 관계로 라우팅됩니다
성공	FlowFiles 이 성공적으로 변환되면 이 관계로 라우팅됩니다

Writes 특성¶

이름	설명
mime.type	Mime.type 특성을 Record Writer가 지정한 MIME 유형으로 설정합니다
record.count	FlowFile 에 있는 레코드의 수
record.error.message	이 특성은 실패 시 리더 또는 작성기가 발생한 오류 메시지를 제공합니다.

사용 사례¶

1개의 레코드 지향 형식에서 다른 형식으로 데이터 변환