ListSFTP 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
SFTP 서버에 있는 파일 목록을 수행합니다. 원격 서버에서 발견되는 각 파일에 대해 파일 이름 특성이 원격 서버의 파일 이름으로 설정된FlowFile이 새로 생성됩니다. 그런 다음 FetchSFTP 와 함께 사용하여 해당 파일을 가져올 수 있습니다.
입력 요구 사항¶
FORBIDDEN
민감한 동적 속성 지원¶
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 |
Connection Timeout |
연결을 생성하는 동안 시간이 초과되기 전에 대기할 시간(초) |
데이터 시간 제한 |
로컬 시스템과 원격 시스템 간에 파일을 전송할 때 시스템 간에 데이터가 전송되지 않고 경과할 수 있는 시간을 지정하는 값입니다 |
파일 필터 정규식 |
파일 이름을 필터링하기 위한 Java 정규식을 제공하며, 필터를 제공하면 해당 정규식과 이름이 일치하는 파일만 가져옵니다 |
호스트 키 파일 |
제공된 파일이 호스트 키로 사용되며, 그렇지 않은 경우 ‘Strict Host Key Checking’ 속성이 적용되면(true로 설정) ~/.ssh 디렉터리의 ‘known_hosts’ 및 ‘known_hosts2’ 파일을 사용하고, 그렇지 않으면 호스트 키 파일이 사용되지 않습니다 |
호스트 이름 |
원격 시스템의 정규화된 호스트 이름 또는 IP 주소입니다 |
점선 파일 무시하기 |
true이면 이름이 점(“.”)으로 시작하는 파일이 무시됩니다 |
허용되는 키 알고리즘 |
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 |
최소 파일 보관 기간 |
파일을 가져오기 위해 필요한 최소 수명; 이보다 오래된 파일(마지막 수정 날짜 기준)은 무시됩니다 |
최소 파일 크기 |
파일을 가져오기 위해 필요한 최소 크기입니다 |
비밀번호 |
사용자 계정의 비밀번호 |
경로 필터 정규식 |
재귀적으로 검색이 true이면 경로가 지정된 정규식과 일치하는 하위 디렉터리만 검색됩니다 |
Port |
원격 시스템이 파일 전송을 위해 수신 대기 중인 포트입니다 |
개인 키 암호 구문 |
개인 키의 비밀번호 |
개인 키 경로 |
개인 키 파일의 정규화된 경로입니다 |
원격 경로 |
파일을 가져오거나 푸시할 원격 시스템의 경로입니다 |
재귀적으로 검색하기 |
true이면 임의로 중첩된 하위 디렉터리에서 파일을 가져오고, 그렇지 않으면 하위 디렉터리를 트래버스하지 않습니다 |
시간 제한에 맞춰 킵 얼라이브 보내기 |
전체 시간 제한 25초 동안 5초마다 최대 5회까지 연결 유지 메시지를 보낼 수 있습니다. |
엄격한 호스트 키 확인 |
호스트 키에 엄격한 적용을 적용할지 여부를 나타냅니다 |
압축 사용 |
파일을 전송할 때 ZLIB 압축을 사용할지 여부를 나타냅니다 |
사용자 이름 |
사용자 이름 |
et-initial-listing-target |
초기 목록 처리 방법을 지정합니다. ‘Tracking Entities’ 전략에서 사용됩니다. |
et-state-cache |
이 프로세서가 NiFi 재시작 또는 기본 노드 변경 시 목록을 재개할 수 있도록 지정된 캐시 저장소에 목록 엔터티가 저장됩니다. ‘Tracking Entities’ 전략은 마지막 ‘Tracking Time Window’ 내에 나열된 모든 엔터티의 추적 정보를 필요로 합니다. 많은 수의 엔터티를 지원하기 위해 이 전략에서는 관리 상태 대신 DistributedMapCache 를 사용합니다. 캐시 키 형식은 ‘ListedEntities::{processorId}(::{nodeId})’입니다. 노드 목록 엔터티별로 추적하는 경우 선택 사항인 ‘::{nodeId}’ 부분이 추가되어 상태를 별도로 관리합니다. 예: 클러스터 차원 캐시 키 = ‘ListedEntities::8dda2321-0164-1000-50fa-3042fe7d6a7b’, 노드별 캐시 키 = ‘ListedEntities::8dda2321-0164-1000-50fa-3042fe7d6a7b::nifi-node3’저장된 캐시 콘텐츠는 Gzip으로 압축된 JSON 문자열입니다. 캐시 키는 대상 목록 구성이 변경되면 삭제됩니다. ‘Tracking Entities’ 전략에서 사용됩니다. |
et-time-window |
이 프로세서가 이미 목록에 있는 엔터티를 추적할 기간을 지정합니다. ‘Tracking Entities’ 전략은 타임스탬프가 지정된 시간 윈도우 내에 있는 엔터티를 선택할 수 있습니다. 예를 들어, ‘30분’으로 설정하면 이 프로세서가 실행될 때 최근 30분 내에 타임스탬프가 있는 모든 엔터티가 목록 대상이 됩니다. 목록에 있는 엔터티는 1. 이미 목록에 있는 엔터티에 존재하지 않거나, 2. 캐시된 엔터티보다 타임스탬프가 더 새롭거나, 3. 캐시된 엔터티와 크기가 다른 경우의 조건 중 하나를 충족하면 ‘신규/업데이트’로 간주되며 FlowFile 이 전송됩니다. 캐시된 엔터티의 타임스탬프가 지정된 시간 윈도우보다 오래되면 해당 엔터티는 캐시된 이미 목록에 있는 엔터티에서 제거됩니다. ‘Tracking Entities’ 전략에서 사용됩니다. |
팔로우 심볼릭 링크 |
true이면, 심볼릭 파일과 중첩된 심볼릭 하위 디렉터리도 가져오고, 그렇지 않으면 심볼릭 파일을 읽지 않고 심볼릭 링크 하위 디렉터리를 트래버스하지 않습니다 |
listing-strategy |
신규/업데이트된 엔터티를 확인하는 방법을 지정합니다. 자세한 내용은 각 전략 설명을 참조하십시오. |
프록시 구성 서비스 |
네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다. |
record-writer |
목록 작성에 사용할 Record Writer를 지정합니다. 지정하지 않으면 목록에 있는 각 엔터티에 대해 FlowFile 이 1개씩 생성됩니다. Record Writer를 지정하면 모든 엔터티는 개별 FlowFiles 에 특성을 추가하는 대신 단일 FlowFile 에 기록됩니다. |
target-system-timestamp-precision |
대상 시스템에서 타임스탬프 전체 자릿수를 지정합니다. 이 프로세서는 엔터티의 타임스탬프를 사용하여 목록에 추가할 엔터티를 결정하므로 타임스탬프의 올바른 전체 자릿수를 사용하는 것이 중요합니다. |
상태 관리¶
범위 |
설명 |
---|---|
CLUSTER |
파일 목록 성능을 수행한 후 최신 파일의 타임스탬프가 저장됩니다. 이렇게 하면 프로세서가 다음에 프로세서를 실행할 때 이 날짜 이후에 추가되거나 수정된 파일만 목록에 표시할 수 있습니다. 상태는 클러스터 전체에 저장되어 이 프로세서가 기본 노드에서만 실행될 수 있으며 새 기본 노드가 선택되면 새 노드는 이전 기본 노드가 나열한 데이터를 복제하지 않습니다. |
관계¶
이름 |
설명 |
---|---|
성공 |
수신된 모든 FlowFiles 은 성공으로 라우팅됩니다 |
Writes 특성¶
이름 |
설명 |
---|---|
sftp.remote.host |
SFTP 서버의 호스트 이름 |
sftp.remote.port |
SFTP 서버에서 연결된 포트 |
sftp.listing.user |
SFTP 목록을 수행한 사용자의 사용자 이름 |
file.owner |
소스 파일의 숫자 소유자 ID입니다 |
file.group |
소스 파일의 숫자 그룹 ID입니다 |
file.permissions |
소스 파일의 읽기/쓰기/실행 권한 |
file.size |
소스 파일의 바이트 수입니다 |
file.lastModifiedTime |
파일 시스템의 파일이 마지막으로 수정된 시점의 타임스탬프는 ‘yyyy-MM-dd’T’HH:mm:ssZ’ 형식으로 표시됩니다. |
파일 이름 |
SFTP 서버에 있는 파일의 이름 |
경로 |
파일을 가져온 SFTP 서버에 있는 디렉터리의 정규화된 이름입니다 |
mime.type |
구성된 Record Writer에서 제공하는 MIME 유형입니다 |