SFTPトラブルシューティングガイド
SFTPコネクターを使用してレシピを設定または実行するときの問題をトラブルシューティングするには、このガイドを使用します。
コネクションが“password must not be longer than 1024 bytes”で失敗する
SFTPコネクションを作成すると、次のエラーが表示される場合があります:
SFTPコネクション失敗エラー
発生する理由
このエラーは、秘密鍵のパスフレーズフィールドに1024文字を超える値が含まれている場合に発生します。 場合によっては、このフィールドに秘密鍵自体が誤って自動入力されます。 Workatoが使用する暗号化ライブラリでは、パスフレーズの長さに1024バイトの制限が適用されるため、コネクションが失敗します。
トラブルシューティング方法
問題を解決するには、次の手順を実行します。
Workatoで新しいSFTPコネクションを作成します。
SSHキーでパスフレーズを使用していない場合は、秘密鍵のパスフレーズフィールドを空白のままにします。 キーでパスフレーズを使用している場合は、手動で入力し、1024文字未満であることを確認します。
新しいコネクションを保存してテストします。
SFTPアップロードがclose streamエラーで失敗する
SFTPサーバーにファイルをアップロードアクションを実行すると、closed streamエラーが表示される場合があります。
発生する理由
このエラーは、次の理由で発生することがあります。
- 対象のSFTPサーバーでネットワーク接続が断続的に発生している。
- SFTPコネクションで小さい転送バッファサイズが使用されている。
- コネクションログに、大きなファイルのアップロードに関する十分な詳細が含まれていない。
トラブルシューティング方法
問題を解決するには、次の手順を実行します。
SFTPコネクション設定で転送バッファサイズを増やします。 デフォルトおよび最小の転送バッファサイズは32768バイト(32 KB)で、最大は327680バイト(320 KB)です。
大きなファイルの転送中にSFTPサーバーが安定しており、到達可能であることを確認します。
ディレクトリ内の新規/更新ファイルトリガーでのNo such fileエラー
ディレクトリ内の新規/更新ファイルトリガーを使用すると、ジョブが次のエラーで失敗する場合があります:
SFTP error 2 : no such file発生する理由
このエラーは、次の理由で発生することがあります。
- 外部SFTPサーバーがダウンロード試行後にファイルを削除する。
- アップロード中にファイルが破損する。
- ネットワークの不安定さにより、ポーリング中のファイルアクセスが中断される。
トラブルシューティング方法
問題を解決するには、次の手順を実行します。
トリガーがファイルをダウンロードするまで、SFTPサーバーが監視対象ディレクトリ内のファイルを保持するようにします。
アップロードされたファイルが完全で、破損していないことを確認します。
WorkatoとSFTPホスト間で断続的なネットワークの問題がないか確認します。
ディレクトリ内の新規/更新CSVファイルトリガーでのNo such fileエラー
ディレクトリ内の新規/更新CSVファイルトリガーを使用すると、No such fileエラーが表示される場合があります。 レシピを再起動した後もエラーが解消されず、同じディレクトリを使用する他のレシピは引き続き動作します。
発生する理由
このエラーは、トリガーがファイルのダウンロードを開始した後、ダウンロード中にSFTPサーバーがそのファイルを削除または移動した場合に発生します。 カーソルが削除されたファイルを参照しているため、トリガーは失敗し続けます。
トラブルシューティング方法
問題を解決するには、次の手順を実行します。
トリガー設定で見つからないファイルを無視しますか?をtrueに設定します。 このオプションにより、トリガーは見つからないファイルをスキップし、新しいファイルの検出を続行できます。
または、問題が解消されない場合は、影響を受けるレシピをクローンし、クローンで見つからないファイルを無視しますか?をtrueに設定してから、元のレシピを停止し、クローンしたレシピを開始します。
Last updated: