FetchFTP 2025.5.31.15¶

번들¶

org.apache.nifi | nifi-standard-nar

설명¶

원격 FTP 서버에서 파일 내용을 가져와서 수신 FlowFile 의 내용을 원격 파일의 내용으로 덮어씁니다.

태그¶

fetch, files, ftp, get, ingest, input, remote, retrieve, source

입력 요구 사항¶

REQUIRED

민감한 동적 속성 지원¶

false

속성¶

속성	설명
Completion Strategy	NiFi 로 가져온 원본 파일을 서버에서 어떻게 처리할지 지정합니다. Completion Strategy가 실패하면 경고가 로그에 기록되지만 데이터는 계속 전송됩니다.
Connection Mode	FTP 연결 모드
Connection Timeout	연결을 생성하는 동안 시간이 초과되기 전에 대기할 시간(초)
Create Directory	‘Completion Strategy’가 ‘Move File’일 때 사용합니다. 원격 디렉터리가 없는 경우 생성할지 여부를 지정합니다.
데이터 시간 제한	로컬 시스템과 원격 시스템 간에 파일을 전송할 때 시스템 간에 데이터가 전송되지 않고 경과할 수 있는 시간을 지정하는 값입니다
호스트 이름	데이터를 가져올 호스트의 정규화된 호스트 이름 또는 IP 주소입니다
Internal Buffer Size	버퍼링된 데이터 스트림에 대한 내부 버퍼 크기 설정
Move Destination Directory	원본 파일이 NiFi 로 수집된 후 원본 파일을 이동할 원격 서버의 디렉터리입니다. 이 속성은 Completion Strategy가 ‘Move File’로 설정되어 있지 않으면 무시됩니다. ‘Create Directory’가 비활성화된 경우 지정된 디렉터리가 원격 시스템에 이미 존재해야 하며, 그렇지 않으면 이름 변경이 실패합니다.
비밀번호	사용자 계정의 비밀번호
Port	데이터를 가져오기 위해 원격 호스트에서 연결할 포트입니다
Remote File	원격 시스템의 정규화된 파일 이름
Transfer Mode	FTP 전송 모드
압축 사용	파일을 전송할 때 ZLIB 압축을 사용할지 여부를 나타냅니다
사용자 이름	사용자 이름
fetchfiletransfer-notfound-loglevel	프로세서가 트리거될 때 파일이 존재하지 않을 경우 사용할 로깅 수준입니다
ftp-use-utf8	파일 및 파일 이름을 처리할 때 클라이언트에 UTF-8 인코딩을 사용하도록 지시합니다. true로 설정하면 서버가 UTF-8 인코딩도 지원해야 합니다.
프록시 구성 서비스	네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다.

관계¶

이름	설명
comms.failure	통신 장애로 인해 원격 서버에서 가져올 수 없는 FlowFile 은 이 관계로 전송됩니다.
not.found	원격 서버에서 ‘찾을 수 없음’ 메시지를 받는 FlowFile 은 이 관계로 전송됩니다.
permission.denied	권한이 부족하여 원격 서버에서 가져올 수 없는 FlowFile 은 이 관계로 전송됩니다.
성공	수신된 모든 FlowFiles 은 성공으로 라우팅됩니다

Writes 특성¶

이름	설명
ftp.remote.host	파일을 가져온 호스트 이름 또는 IP 주소
ftp.remote.port	원격 FTP 서버와 통신하는 데 사용되는 포트입니다
ftp.remote.filename	가져온 원격 파일의 이름입니다
파일 이름	파일 이름이 원격 파일의 파일 이름을 가리키도록 업데이트됩니다
경로	원격 파일에 디렉터리 이름이 포함된 경우 해당 디렉터리 이름은 ‘경로’ 특성을 사용하여 FlowFile 에 추가됩니다
fetch.failure.reason	장애 관계로 라우팅할 때 적용되는 장애 관계의 이름입니다

다른 구성 요소가 포함된 사용 사례¶

FTP 서버의 디렉터리에서 모든 파일 검색하기

참고 항목¶