PutSQL 2025.10.2.19¶

JDBC 接続プール

JSON メッセージを SQL ステートメントに変換するために使用する JDBC 接続プールを指定します。接続プールは、適切なデータベース列タイプを決定するために必要です。

断片化されたトランザクションのサポート

trueの場合、FlowFileがこのプロセッサーで消費されるとき、プロセッサーはまずそのFlowFileの fragment.identifier属性とfragment.count属性をチェックします。fragment.countの値が1より大きい場合、プロセッサーは、そのfragment.identifierを持つFlowFileを、すべてが利用可能になるまで処理しません。その時点で、そのfragment.identifierを持つすべてのFlowFilesを、FlowFilesの「fragment.index」属性で指定された順序で、単一のトランザクションとして処理します。これにより、これらのSQLステートメントの原子性が提供されます。このトランザクションのいずれかのステートメントが実行時に例外をスローすると、このトランザクションはロールバックされます。トランザクションのロールバックが起こると、これらのFlowFilesのどれもが「success」にルーティングされません。<Rollback On Failure>がtrueに設定されている場合、これらのFlowFilesは入力リレーションシップに留まります。<Rollback On Failure>がfalseに設定されている場合、これらのFlowFilesのいずれかが「retry」にルーティングされると、これらのFlowFilesのすべてが「retry」にルーティングされます。そうでなければ、これらは「failure」にルーティングされます。この値がfalseの場合、これらの属性は無視され、更新は互いに独立して行われます。

database-session-autocommit

使用するデータベース接続にセットする自動コミットモード。false にセットすると、操作は明示的にコミットまたはロールバックされます (それぞれ成功または失敗に基づいて)。trueにセットすると、ドライバー/データベースがコミット/ロールバックを操作します。

rollback-on-failure

エラーの処理方法を指定します。デフォルト（false）では、FlowFileの処理中にエラーが発生した場合、FlowFileはエラーの種類に基づいて「失敗」または「再試行」リレーションシップにルーティングされ、プロセッサーは次のFlowFileに進むことができます。その代わりに、現在処理中のFlowFilesをロールバックし、それ以降の処理を即座に停止したい場合があるかもしれません。その場合は、この「Rollback On Failure」プロパティを有効にしてください。有効な場合、失敗したFlowFilesはペナルティを受けることなく入力リレーションシップに留まり、処理に成功するか他の手段で削除されるまで繰り返し処理されます。リトライの頻度が高くなりすぎないよう、適切な「Yield Duration」を設定することが重要です。

retry

データベースを更新できない場合、 FlowFile はこのリレーションシップにルーティングされますが、再度操作を試みると成功する可能性があります。