アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> getTabularResult
 
getTabularResult
executeNativeSqlまたはexecuteSqlの呼び出しから返された、または出力に含まれるresultIdに関連付けられた表形式の結果を取得しますexecuteProcedureまたはexecuteSqlScriptへの呼び出しのエレメント。
「isBlocking」がTRUEに設定されている場合、このオペレーションは、実行に関連付けられた処理が完了し、「outputs」エレメントが設定されるまで戻りません。
FALSEに設定すると、実行に関連する処理が完了するとこのオペレーションが返されますが、「outputs」エレメントにデータが入力されるのを待つことはありません。
includeMetadataがTRUEの場合、応答にはメタデータエレメントが含まれます。メタデータエレメントは、この呼び出しまたは後のgetTabularResultの呼び出しのいずれかで結果に提供される列データの名前とタイプを記述します。
完了したエレメントは、考えられるすべての結果が取得されたかどうかを報告します。
requestStatusエレメントは、実行に関連付けられたサーバー要求のステータスを報告します。リクエストのステータスは、次のいずれかになります。
STARTED:リクエストが開始されました。リクエストは作成されましたが、まだ実行されていません。
WAITING:サーバーが要求を処理するために、要求はキューで待機しています。実行中:リクエストは現在サーバーによって実行されています。
COMPLETED:リクエストに関連付けられた実行が完了しました。結果を取得できるようになりました。
CLOSING:リクエストは終了します。
SUCCESS:リクエストは正常に終了しました。
FAILURE:リクエストは失敗して終了しました。
TERMINATED:リクエストは終了しました。
skipRowsが設定されている場合、結果を返す前に、その行数が実行出力でスキップされます。 skipRowsが可能な行の総数よりも大きい場合、行は返されません。
maxRowsが設定されている場合、結果には最大でmaxRowsの行数が含まれます。 maxRowsが使用可能なデータの行の総数よりも小さい場合、残りの使用可能なデータを取得するには、getTabularResultを追加で呼び出す必要があります。結果でhasMoreRowsエレメントを使用して、追加のデータが使用可能かどうかを判別します。これは、サーバーがmaxRowsより少ない数を返すことを選択する可能性があるため、maxRowsで返される行数を比較するよりも正確です。
消費RemainingRowsが設定され、TRUEの場合、maxRowsを超える残りのすべての行が消費されます。
この実行によって影響を受けた行の数がわかっている場合は、rowsAffectedエレメントが設定されます。これには、スキップされた(skipRowsエレメントを参照)または消費された(consumedRemainingRowsエレメントを参照)行の数が含まれます。
ロケーション
/services/webservices/system/admin/execute/operations/
リクエストエレメント
resultId:結果ID。
isBlocking(オプション):TRUE(デフォルト)の場合、実行が完了するまで戻らないでください。
includeMetadata(オプション):TRUEの場合、応答には列名とそのタイプに関する情報が含まれます。デフォルトはFALSEです。
skipRows(オプション):結果を生成する前に実行出力でスキップする行数。設定されていない場合、行はスキップされません。
maxRows(オプション):返される行の最大数。設定されていない場合、すべての行が返されます。
ConsumerRemainingRows(オプション):設定してTRUEの場合、maxRows以降の残りのすべての行が消費されます。
応答エレメント
completed:TRUEの場合、実行に関連するすべての処理が完了しています。
requestStatus:実行を実行しているサーバーリクエストのステータス。
メタdata(オプション):結果内の列名とタイプをリストするテーブルメタデータ:
列:列エレメントを参照してください。
rowsAffected(オプション):既知の場合、実行によって影響を受ける行の数。それ以外の場合は設定されていません。
結果(オプション):結果データ。
hasMoreRows:テーブルに影響を受ける数(上記のrowsAffected)よりも多くの行がある場合はTRUE。
totalRowCount:テーブル内の行の総数。
エラー解析
IllegalArgument:isBlocking、includeMetadata、またはmaxRowsエレメントの形式が正しくない場合。
NotFound:resultIdが現在のトランザクション内に存在しないか、すでに閉じられている場合。
RuntimeError:実行中にエラーが発生した場合。これが発生した場合、resultIdは閉じられます。