FetchSFTP 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
원격 SFTP 서버에서 파일 내용을 가져와서 수신 FlowFile 의 내용을 원격 파일의 내용으로 덮어씁니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
암호화 허용됨 |
SFTP 연결에 허용되는 쉼표로 구분된 암호 목록입니다. 모두 허용하려면 설정하지 않은 상태로 둡니다. 사용 가능한 옵션: 3des-cbc, 3des-ctr, aes128-cbc, aes128-ctr, aes128-gcm@openssh.com, aes192-cbc, aes192-ctr, aes256-cbc, aes256-ctr, aes256-gcm@openssh.com, arcfour, arcfour128, arcfour256, blowfish-cbc, blowfish-ctr, cast128-cbc, cast128-ctr, chacha20-poly1305@openssh.com, idea-cbc, idea-ctr, serpent128-cbc, serpent128-ctr, serpent192-cbc, serpent192-ctr, serpent256-cbc, serpent256-ctr, twofish-cbc, twofish128-cbc, twofish128-ctr, twofish192-cbc, twofish192-ctr, twofish256-cbc, twofish256-ctr |
Completion Strategy |
NiFi 로 가져온 원본 파일을 서버에서 어떻게 처리할지 지정합니다. Completion Strategy가 실패하면 경고가 로그에 기록되지만 데이터는 계속 전송됩니다. |
Connection Timeout |
연결을 생성하는 동안 시간이 초과되기 전에 대기할 시간(초) |
Create Directory |
‘Completion Strategy’가 ‘Move File’일 때 사용합니다. 원격 디렉터리가 없는 경우 생성할지 여부를 지정합니다. |
데이터 시간 제한 |
로컬 시스템과 원격 시스템 간에 파일을 전송할 때 시스템 간에 데이터가 전송되지 않고 경과할 수 있는 시간을 지정하는 값입니다 |
Disable Directory Listing |
‘Completion Strategy’가 ‘Move File’이고 ‘Create Directory’가 활성화된 경우 ‘Move Destination Directory’가 생성되는 방식을 제어합니다. ‘true’로 설정하면 누락된 디렉터리를 생성하기 전에 디렉터리 목록이 수행되지 않습니다. 기본적으로 이 프로세서는 누락된 디렉터리를 생성하기 전에 디렉터리 목록 명령을 실행하여 대상 디렉터리의 존재를 확인합니다. 그러나 다음과 같이 디렉터리 목록을 비활성화해야 하는 상황이 있을 수 있습니다. 디렉터리에 대한 일부 권한 설정(예: chmod 100)으로 디렉터리 목록이 실패할 수 있습니다. 또한 이 프로세서가 목록 성능을 수행한 후 이 프로세서의 디렉터리 생성 요청이 완료되기 전에 다른 SFTP 클라이언트가 디렉터리를 생성한 경우 디렉터리가 이미 존재하므로 오류가 반환됩니다. |
호스트 키 파일 |
제공된 파일이 호스트 키로 사용되며, 그렇지 않은 경우 ‘Strict Host Key Checking’ 속성이 적용되면(true로 설정) ~/.ssh 디렉터리의 ‘known_hosts’ 및 ‘known_hosts2’ 파일을 사용하고, 그렇지 않으면 호스트 키 파일이 사용되지 않습니다 |
호스트 이름 |
데이터를 가져올 호스트의 정규화된 호스트 이름 또는 IP 주소입니다 |
허용되는 키 알고리즘 |
SFTP 연결에 허용되는 쉼표로 구분된 키 알고리즘 목록입니다. 모두 허용하려면 설정하지 않은 상태로 둡니다. 사용 가능한 옵션: ecdsa-sha2-nistp256, ecdsa-sha2-nistp256-cert-v01@openssh.com, ecdsa-sha2-nistp384, ecdsa-sha2-nistp384-cert-v01@openssh.com, ecdsa-sha2-nistp521, ecdsa-sha2-nistp521-cert-v01@openssh.com, rsa-sha2-256, rsa-sha2-512, ssh-dss, ssh-dss-cert-v01@openssh.com, ssh-ed25519, ssh-ed25519-cert-v01@openssh.com, ssh-rsa, ssh-rsa-cert-v01@openssh.com |
허용되는 키 교환 알고리즘 |
SFTP 연결에 허용되는 쉼표로 구분된 키 교환 알고리즘 목록입니다. 모두 허용하려면 설정하지 않은 상태로 둡니다. 사용 가능한 옵션: curve25519-sha256, curve25519-sha256@libssh.org, diffie-hellman-group-exchange-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group1-sha1, diffie-hellman-group14-sha1, diffie-hellman-group14-sha256, diffie-hellman-group14-sha256@ssh.com, diffie-hellman-group15-sha256, diffie-hellman-group15-sha256@ssh.com, diffie-hellman-group15-sha384@ssh.com, diffie-hellman-group15-sha512, diffie-hellman-group16-sha256, diffie-hellman-group16-sha384@ssh.com, diffie-hellman-group16-sha512, diffie-hellman-group16-sha512@ssh.com, diffie-hellman-group17-sha512, diffie-hellman-group18-sha512, diffie-hellman-group18-sha512@ssh.com, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, ext-info-c |
허용되는 메시지 인증 코드 수 |
SFTP 연결에 허용되는 쉼표로 구분된 메시지 인증 코드 목록입니다. 모두 허용하려면 설정하지 않은 상태로 둡니다. 사용 가능한 옵션: hmac-md5, hmac-md5-96, hmac-md5-96-etm@openssh.com, hmac-md5-etm@openssh.com, hmac-ripemd160, hmac-ripemd160-96, hmac-ripemd160-etm@openssh.com, hmac-ripemd160@openssh.com, hmac-sha1, hmac-sha1-96, hmac-sha1-96@openssh.com, hmac-sha1-etm@openssh.com, hmac-sha2-256, hmac-sha2-256-etm@openssh.com, hmac-sha2-512, hmac-sha2-512-etm@openssh.com |
Move Destination Directory |
원본 파일이 NiFi 로 수집된 후 원본 파일을 이동할 원격 서버의 디렉터리입니다. 이 속성은 Completion Strategy가 ‘Move File’로 설정되어 있지 않으면 무시됩니다. ‘Create Directory’가 비활성화된 경우 지정된 디렉터리가 원격 시스템에 이미 존재해야 하며, 그렇지 않으면 이름 변경이 실패합니다. |
비밀번호 |
사용자 계정의 비밀번호 |
Port |
데이터를 가져오기 위해 원격 호스트에서 연결할 포트입니다 |
개인 키 암호 구문 |
개인 키의 비밀번호 |
개인 키 경로 |
개인 키 파일의 정규화된 경로입니다 |
Remote File |
원격 시스템의 정규화된 파일 이름 |
시간 제한에 맞춰 킵 얼라이브 보내기 |
전체 시간 제한 25초 동안 5초마다 최대 5회까지 연결 유지 메시지를 보낼 수 있습니다. |
엄격한 호스트 키 확인 |
호스트 키에 엄격한 적용을 적용할지 여부를 나타냅니다 |
압축 사용 |
파일을 전송할 때 ZLIB 압축을 사용할지 여부를 나타냅니다 |
사용자 이름 |
사용자 이름 |
fetchfiletransfer-notfound-loglevel |
프로세서가 트리거될 때 파일이 존재하지 않을 경우 사용할 로깅 수준입니다 |
프록시 구성 서비스 |
네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다. |
관계¶
이름 |
설명 |
|---|---|
comms.failure |
통신 장애로 인해 원격 서버에서 가져올 수 없는 FlowFile 은 이 관계로 전송됩니다. |
not.found |
원격 서버에서 ‘찾을 수 없음’ 메시지를 받는 FlowFile 은 이 관계로 전송됩니다. |
permission.denied |
권한이 부족하여 원격 서버에서 가져올 수 없는 FlowFile 은 이 관계로 전송됩니다. |
성공 |
수신된 모든 FlowFiles 은 성공으로 라우팅됩니다 |
Writes 특성¶
이름 |
설명 |
|---|---|
sftp.remote.host |
파일을 가져온 호스트 이름 또는 IP 주소 |
sftp.remote.port |
원격 SFTP 서버와 통신하는 데 사용되는 포트입니다 |
sftp.remote.filename |
가져온 원격 파일의 이름입니다 |
파일 이름 |
파일 이름이 원격 파일의 파일 이름을 가리키도록 업데이트됩니다 |
경로 |
원격 파일에 디렉터리 이름이 포함된 경우 해당 디렉터리 이름은 ‘경로’ 특성을 사용하여 FlowFile 에 추가됩니다 |
fetch.failure.reason |
장애 관계로 라우팅할 때 적용되는 장애 관계의 이름입니다 |
다른 구성 요소가 포함된 사용 사례¶
SFTP 서버의 디렉터리에서 모든 파일 검색하기 |