ExtractEmailHeaders 2025.10.9.21 — 이메일 헤더 추출 프로세서
ExtractEmailHeaders 2025.10.9.21 — 이메일 헤더 추출 프로세서
ExtractEmailHeaders 프로세서는 flow file의 내용을 데이터 소스로 사용해서 RFC 호환 이메일 파일에서 헤더를 추출하고 관련 속성을 flow file에 추가해요. RFC 2822의 최소한의 요구사항을 충족해야 해요.
출처: Snowflake 문서
본문
기능 — 일반 공개 (Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP의 상용 리전에서 모든 계정에 제공돼요.
Openflow BYOC 배포는 AWS의 상용 리전에서 모든 계정에 제공돼요.
Bundle
org.apache.nifi | nifi-email-nar
Description
flow file의 내용을 데이터 소스로 사용해서 RFC 호환 이메일 파일에서 헤더를 추출하고 관련 속성을 flow file에 추가해요. 이 프로세서는 광범위한 RFC 검증을 수행하지는 않지만 RFC 2822에 대한 최소한의 준수는 요구해요.
Tags
email, split
Input Requirement
REQUIRED
Supports Sensitive Dynamic Properties
false
Properties
| Property | Description |
|---|---|
| Additional Header List | flow file 내용에서 추가로 추출할 헤더 목록으로, COLON으로 구분돼요. 참고로 헤더 키는 대소문자를 구분하지 않으며 소문자로 매칭돼요. 값은 이메일 내용을 따릅니다 |
| Email Address Parsing | "strict"면 "to", "from" 헤더 같은 mailbox 및 mailbox list 필드에 엄격한 주소 형식 파싱 규칙이 적용되고, 형식이 잘못된 주소가 있는 FlowFile은 RFC 호환 형식 검증에 실패한 메시지와 마찬가지로 failure 관계로 라우팅돼요. "non-strict"면 프로세서는 mailbox list 헤더의 내용을 각 값이 잘 구성된 인터넷 mailbox 주소인지 파싱하지 않고 쉼표로 구분된 값으로 추출해요. 이는 선택 사항이며 기본값은 Strict Address Parsing이에요 |
Relationships
| Name | Description |
|---|---|
| failure | RFC-2822 호환 메시지로 파싱할 수 없었던 FlowFile들이에요 |
| success | 추출이 성공했어요 |
Writes attributes
| Name | Description |
|---|---|
| email.headers.bcc.* | 각 개별 BCC 수신자 (있을 경우) |
| email.headers.cc.* | 각 개별 CC 수신자 (있을 경우) |
| email.headers.from.* | 이메일의 From에 포함된 각 개별 mailbox (RFC-2822에 따라 배열) |
| email.headers.message-id | Message-ID 헤더의 값 (있을 경우) |
| email.headers.received_date | 메시지의 Received-Date (있을 경우) |
| email.headers.sent_date | 메시지가 전송된 날짜 |
| email.headers.subject | 메시지의 제목 (있을 경우) |
| email.headers.to.* | 각 개별 TO 수신자 (있을 경우) |
| email.attachment_count | 메시지의 첨부파일 수 |