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

더 알아보기 (Learn more)