RemoveFieldRecordReader

RemoveFieldRecordReader (필드 제거 레코드 리더)

NiFi Records에서 지정된 필드를 걸러내는 것을 지원하는 RecordReaderFactory 래퍼예요. 사용자는 감싸진 RecordReaderFactory가 반환한 레코드 리더로 레코드를 읽을 때 무시해야 할 필드 이름 목록을 지정할 수 있어요.

출처: 문서

본문

설명

NiFi Records에서 지정된 필드를 걸러내는 것을 지원하는 RecordReaderFactory 래퍼예요. 감싸진 RecordReaderFactory가 반환한 레코드 리더로 레코드를 읽을 때 무시해야 할 필드 이름 목록을 지정할 수 있어요. 무시할 레코드 필드는 동적 속성(dynamic properties)으로 지정해요. 동적 속성이 최소 하나는 설정되어야 해요. 동적 속성 이름은 제거할 필드에 대한 설명으로 사용되고, 동적 속성 값은 제거할 필드를 식별하는 RecordPath예요. 중첩 경로가 지원돼요. 루트 경로("/")를 대상으로 하는 레코드 경로는 허용되지 않으며 검증 오류가 발생해요. 이 서비스는 다음 조건이 모두 충족될 때 사용해야 해요.

  • 위임된 RecordReaderFactory가 데이터에서 스키마를 추론(infer)하도록 설정되어 있고
  • 읽는 데이터에 정적 스키마를 정의하지 않았거나 정의하고 싶지 않고
  • 무시하도록 설정한 필드가 보안 또는 성능 이유로 NiFi 콘텐츠 저장소에 직렬화되지 않아야 하는 경우

위 조건 중 하나라도 충족되지 않으면 RecordFieldRemover 프로세서를 사용하는 것을 고려하세요. 참고: 이 구현이 반환하는 RecordReader는 알 수 없는 필드를 무시(ignore)하는 대신 버리도록(drop) 하드코딩되어 있어요. RecordReader의 nextRecord(coerceTypes, dropUnknownFields) 메서드를 dropUnknownFields를 false로 호출해도 여전히 알 수 없는 필드를 버려요.

태그

delete, field, filter, reader, record, remove

속성 (Properties)

아래 목록에서 필수 속성은 별표(*)로 표시했어요. 그 외 속성은 선택 사항이고, 표에는 기본값과 NiFi Expression Language 지원 여부도 함께 나와 있어요.

표시 이름 API 이름 기본값 허용 값 설명
Record Reader * Record Reader 필터링이 적용되기 전에 레코드를 읽는 데 사용할 기본 RecordReaderFactory 서비스예요.

상태 관리

이 컴포넌트는 상태를 저장하지 않아요.

제한 사항 (Restricted)

이 컴포넌트는 제한되지 않아요.

시스템 리소스 고려 사항

이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.

더 알아보기 (Learn more)