ロングポーリングによる API コールの削減

ステートメントが待機時間内に完了した場合、レスポンスには、オペレーションに応じて終了ステータスまたは結果データが含まれます。

待機時間が経過してもステートメントがまだ実行中の場合、レスポンスは現在の進行中のステータスを返します。

ロングポーリングリクエストが行われる前にステートメントが既に完了している場合、API は直ちに終了ステータスを返します。

WaitTimeSeconds を省略した場合、デフォルトの非同期動作が保持されます。

短いクエリを送信して完了を待つ – WaitTimeSeconds を指定して ExecuteStatement を使用します。クエリが終了するか、待機時間が経過すると、レスポンスはステートメントの Status、RedshiftPid、および HasResultSet を返します。完全なステートメントメタデータを取得するには、DescribeStatement を呼び出します。HasResultSet が true の場合、GetStatementResult を呼び出して結果を取得します。

ステータスのロングポーリング – ExecuteStatement を使用してクエリを送信し、WaitTimeSeconds を指定して DescribeStatement を呼び出します。クエリが終了すると、DescribeStatement はステータス、所要時間、エラーの詳細を含むステートメントの完全なメタデータを返します。

結果のロングポーリング – ExecuteStatement を使用してクエリを送信し、WaitTimeSeconds を指定して GetStatementResult を呼び出します。クエリが終了すると、結果データが直接返されます。待機時間が経過してもクエリがまだ実行されている場合、結果がまだ利用できないことを示す ResourceNotFoundException が返されます。

複数のクエリを送信し、バッチ全体が完了するまで待機する – WaitTimeSeconds を指定して BatchExecuteStatement を使用します。呼び出しは、すべてのサブステートメントが完了するまで維持され、バッチの親 ID と全体的なステータスが返されます。

複数のクエリを送信し、サブステートメントのステータスをロングポーリングする – サブステートメント ID と WaitTimeSeconds を指定して DescribeStatement または GetStatementResult を使用します。そのサブステートメントが終了すると、バッチの残りの処理を待たずに、すぐに結果を返します。