FetchSFTP 2025.10.2.19¶
バンドル¶
org.apache.nifi | nifi-standard-nar
説明¶
リモートの SFTP サーバーからファイルのコンテンツを取得し、受信 FlowFile のコンテンツ をリモートファイルのコンテンツで上書きします。
入力要件¶
REQUIRED
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
|---|---|
アルゴリズム交渉 |
SSH アルゴリズムネゴシエーションの構成戦略 |
許可される暗号 |
A comma-separated list of Ciphers allowed for SFTP connections. Leave unset to allow all. Available options are: 3des-cbc, aes128-cbc, aes128-ctr, aes128-gcm@openssh.com, aes192-cbc, aes192-ctr, aes256-cbc, aes256-ctr, aes256-gcm@openssh.com, arcfour128, arcfour256, blowfish-cbc, chacha20-poly1305@openssh.com, none |
完成ストラテジー |
NiFi に取り込まれた後、サーバー上のオリジナルファイルをどうするかを指定します。完成ストラテジー が失敗した場合、警告はログに記録されますが、データは転送されます。 |
接続タイムアウト |
接続作成中にタイムアウトするまでの待機時間 |
ディレクトリの作成 |
「完成ストラテジー」が「ファイルの移動」の場合に使用されます。リモートディレクトリが存在しない場合に作成するかどうかを指定します。 |
データタイムアウト |
ローカルとリモートのシステム間でファイルを転送する場合、この値はシステム間でデータが転送されずに経過する時間を指定します。 |
ディレクトリリストの無効化 |
「完了ストラテジー」が「ファイルの移動」で「ディレクトリの作成」が有効な場合に、「移動先ディレクトリ」をどのように作成するかを制御します。「true」にセットすると、見つからないディレクトリを作成する前にディレクトリリストを作成しません。デフォルトでは、このプロセッサーは、見つからないディレクトリを作成する前に、ディレクトリリストコマンドを実行してターゲットディレクトリの存在を確認します。しかし、以下のようなディレクトリリストを無効にする必要がある場合もあります。ディレクトリのパーミッション設定（chmod 100など）によっては、ディレクトリリストに失敗することがあります。また、このプロセッサーがリストを実行した後、このプロセッサーによるディレクトリ作成リクエストが終了する前に、他の SFTP クライアントがディレクトリを作成した場合、そのディレクトリはすでに存在するため、エラーが返されます。 |
ホストキーファイル |
提供されている場合、与えられたファイルがホストキーとして使用されます。そうでない場合、'Strict Host Key Checking' プロパティが適用されている (true にセットされている) 場合、~/.ssh ディレクトリの 'known_hosts' および 'known_hosts2' ファイルを使用します。 |
ホスト名 |
データを取得するホストの完全修飾ホスト名または IP アドレス。 |
許可されるキーアルゴリズム |
A comma-separated list of Key Algorithms allowed for SFTP connections. Leave unset to allow all. Available options are: 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-256-cert-v01@openssh.com, rsa-sha2-512, rsa-sha2-512-cert-v01@openssh.com, sk-ecdsa-sha2-nistp256@openssh.com, sk-ssh-ed25519@openssh.com, ssh-dss, ssh-dss-cert-v01@openssh.com, ssh-ed25519, ssh-ed25519-cert-v01@openssh.com, ssh-rsa, ssh-rsa-cert-v01@openssh.com |
許可されるキー交換アルゴリズム |
A comma-separated list of Key Exchange Algorithms allowed for SFTP connections. Leave unset to allow all. Available options are: curve25519-sha256, curve25519-sha256@libssh.org, curve448-sha512, diffie-hellman-group-exchange-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group1-sha1, diffie-hellman-group14-sha1, diffie-hellman-group14-sha256, diffie-hellman-group15-sha512, diffie-hellman-group16-sha512, diffie-hellman-group17-sha512, diffie-hellman-group18-sha512, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, mlkem1024nistp384-sha384, mlkem768nistp256-sha256, mlkem768x25519-sha256, sntrup761x25519-sha512, sntrup761x25519-sha512@openssh.com |
許可されるメッセージ認証コード |
A comma-separated list of Message Authentication Codes allowed for SFTP connections. Leave unset to allow all. Available options are: hmac-md5, hmac-md5-96, hmac-sha1, hmac-sha1-96, hmac-sha1-etm@openssh.com, hmac-sha2-256, hmac-sha2-256-etm@openssh.com, hmac-sha2-512, hmac-sha2-512-etm@openssh.com |
宛先ディレクトリの移動 |
NiFi に取り込まれた後、オリジナルファイルを移動するリモートサーバー上のディレクトリ。このプロパティは、完成ストラテジー が 「ファイルの移動」 にセットされていない限り、無視されます。「ディレクトリの作成」が無効になっている場合、指定されたディレクトリがリモートシステム上に既に存在する必要があります。 |
パスワード |
ユーザーアカウントのパスワード |
ポート |
データを取得するためにリモートホストで接続するポート。 |
秘密キーパスフレーズ |
秘密キーのパスワード |
秘密キーパス |
秘密キーファイルへの許可された完全パス。 |
リモートファイル |
リモートシステム上の完全修飾ファイル名 |
タイムアウト時にキープアライブを送信 |
最大5回まで5秒ごとにKeep Aliveメッセージを送信し、全体のタイムアウトは25秒です。 |
厳格なホスト・キー・チェック |
ホストキーの厳格な適用を行うかどうかを示します。 |
コンプレッションの使用 |
ファイル転送時に ZLIB 圧縮を使用するかどうかを示します。 |
ユーザー名 |
ユーザー名 |
fetchfiletransfer-notfound-loglevel |
プロセッサーがトリガーされたときにファイルが存在しない場合に使用するログレベル |
proxy-configuration-service |
ネットワークリクエストをプロキシするプロキシ構成Controller Serviceを指定します。 |
リレーションシップ¶
名前 |
説明 |
|---|---|
comms.failure |
通信障害によりリモートサーバーから取得できなかった FlowFile は、この Relationship に転送されます。 |
not.found |
リモートサーバーから「Not Found」メッセージを受信した FlowFile は、この Relationship に転送されます。 |
permission.denied |
権限不足のためリモートサーバーから取得できなかった FlowFile は、この Relationship に転送されます。 |
success |
受信したすべての FlowFiles は成功にルーティングされます。 |
属性の書き込み¶
名前 |
説明 |
|---|---|
sftp.remote.host |
ファイルの取得元のホスト名または IP アドレス |
sftp.remote.port |
リモート SFTP サーバーとの通信に使用されたポート。 |
sftp.remote.filename |
引き出されたリモートファイルの名前 |
filename |
ファイル名はリモートファイルのファイル名を指すように更新されます。 |
path |
リモートファイルにディレクトリ名が含まれている場合、そのディレクトリ名は 'path' 属性を使用して FlowFile に追加されます。 |
fetch.failure.reason |
任意の失敗リレーションシップへのルーティング時に適用される失敗リレーションシップの名前 |
他のコンポーネントを含むユースケース¶
SFTP サーバーのディレクトリ内のすべてのファイルを取得します。 |