FetchFile 2025.10.9.21 — 로컬 파일 가져오기 프로세서
FetchFile 2025.10.9.21 — 로컬 파일 가져오기 프로세서
FetchFile 프로세서는 디스크에서 파일 내용을 읽어 들어오는 FlowFile의 내용으로 스트리밍해요. 완료되면 파일 시스템을 정리하기 위해 파일을 선택적으로 다른 곳으로 이동하거나 삭제할 수 있어요.
출처: Snowflake 문서
본문
기능 — 일반 공개 (Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP의 상용 리전에서 모든 계정에 제공돼요.
Openflow BYOC 배포는 AWS의 상용 리전에서 모든 계정에 제공돼요.
Bundle
org.apache.nifi | nifi-standard-nar
Description
디스크에서 파일 내용을 읽어 들어오는 FlowFile의 내용으로 스트리밍해요. 완료되면 파일 시스템을 정리하는 데 도움이 되도록 파일을 선택적으로 다른 곳으로 이동하거나 삭제해요.
Tags
fetch, files, filesystem, get, ingest, ingress, input, local, source
Input Requirement
REQUIRED
Supports Sensitive Dynamic Properties
false
Properties
| Property | Description |
|---|---|
| Completion Strategy | 파일이 NiFi로 가져와진 후 파일 시스템의 원본 파일을 어떻게 처리할지 지정해요 |
| File to Fetch | 파일 시스템에서 가져올 파일의 전체 자격을 갖춘(fully-qualified) 파일 이름 |
| Log level when file not found | 프로세서가 트리거될 때 파일이 존재하지 않는 경우 사용할 로그 수준 |
| Log level when permission denied | 현재 애플리케이션 사용자에게 파일을 읽을 충분한 권한이 없는 경우 사용할 로그 수준 |
| Move Conflict Strategy | Completion Strategy가 Move File로 설정되고 대상 디렉터리에 같은 이름의 파일이 이미 존재하면, 이 속성이 명명 충돌을 해결하는 방법을 지정해요 |
| Move Destination Directory | 파일을 파일 시스템에서 가져온 후 원본 파일을 이동할 디렉터리예요. Completion Strategy가 "Move File"로 설정되지 않으면 이 속성은 무시돼요. 디렉터리가 없으면 생성돼요 |
Restrictions
| Required Permission | Explanation |
|---|---|
| read filesystem | 운영자에게 NiFi가 접근할 수 있는 모든 파일을 읽을 수 있는 능력을 제공해요 |
| write filesystem | 운영자에게 NiFi가 접근할 수 있는 모든 파일을 삭제할 수 있는 능력을 제공해요 |
Relationships
| Name | Description |
|---|---|
| failure | 권한 부족이나 파일 없음 이외의 어떤 이유로든 파일 시스템에서 가져올 수 없었던 FlowFile이 이 관계로 전달돼요 |
| not.found | 파일을 찾을 수 없어 파일 시스템에서 가져올 수 없었던 FlowFile이 이 관계로 전달돼요 |
| permission.denied | NiFi를 실행하는 사용자에게 충분한 권한이 없어 파일 시스템에서 가져올 수 없었던 FlowFile이 이 관계로 전달돼요 |
| success | 파일 시스템에서 성공적으로 가져온 FlowFile이 이 관계로 전달돼요 |
Use Cases Involving Other Components
| Ingest all files from a directory into NiFi |
|---|
| 디렉터리의 모든 파일을 NiFi로 수집해요 |
| Ingest specific files from a directory into NiFi, filtering on filename |
| 파일 이름으로 필터링해서 디렉터리의 특정 파일을 NiFi로 수집해요 |
See also
- org.apache.nifi.processors.standard.GetFile
- org.apache.nifi.processors.standard.ListFile
- org.apache.nifi.processors.standard.PutFile