Sync Mode とは?

Sync Mode は、クライアントがファイルの転送と処理の完了を待ってから最終的な Assembly の結果を受け取る、Transloadit の動作モードです。そのため、リクエストはワークフローの実行中ずっと開いたままになります。

Sync Mode の仕組み

Transloadit の Sync Mode では、呼び出し元から見ると、送信から完了した Assembly のステータス取得までが、単一のブロッキング型リクエスト・レスポンスで行われます。アップロードと処理の各 Step の実行中は接続が占有され、完了後は最終結果をすぐに利用できます。この結び付きにより、短い逐次処理の連携は簡単になりますが、ワークフローの所要時間が HTTP タイムアウトや接続容量の問題に直結します。Sync Mode は API オーケストレーションの境界で用いる方式です。一方、非同期連携では Assembly の識別子を永続化し、後で完了通知を受け取るか、完了状態を取得します。

要点

  1. 呼び出し元でタイムアウトが発生しても、処理ジョブは中継システムのリクエスト期限を超えて続く場合があります。そのため、再試行ロジックでは、同期レスポンスがないことを、Assembly が作成されなかった証拠として扱ってはいけません。
  2. ブラウザー、リバースプロキシ、ロードバランサー、サーバーレス環境では、時間制限が異なる場合があります。長時間のトランスコードやリモートインポート中に同期呼び出しを維持できるかどうかは、最も短い制限で決まります。
  3. Sync Mode が変えるのは完了を伝える方法であり、Assembly の各 Step 自体の処理の意味ではありません。依存関係の解決方法と結果の構造は、引き続き設定されたワークフローによって決まります。

Sync Mode が重要になる場面

呼び出し元が安全に待機でき、次の処理に進む前に完了した結果を必要とする場合は、Sync Mode を選んでください。処理が長い場合や所要時間が変動する場合は、クライアント、プロキシ、サーバーのタイムアウトを超えることがあるため、非同期処理の方が信頼性が高くなります。

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す