機械翻訳について
  1. Oracle Analytics CloudのためのREST API
  2. タスク
  3. カタログ
  4. シーケンス

シーケンスの実行履歴の取得

get

/api/20210901/catalog/sequences/{sequenceId}/history

シーケンスの実行履歴の取得

リクエスト

パス・パラメータ
  • Base64エンコーディングのシーケンスのオブジェクトID。 たとえば、順序のオブジェクトIDが'User1'の場合、'sequence1'は、Base64エンコード値J1VzZXIxJy4nc2VxdWVuY2UxJw== を入力します。
問合せパラメータ
  • この値の後に開始時間を持つジョブを取得します。 使用可能な形式は、yyyy-MM-dd'T'HH:mm:ss.SZ、yyyy-MM-dd HH:mm:ss、yyyy-MM-ddです。
  • 指定可能な値:\\ trueまたはfalse。 デフォルト値はtrueです。 trueの場合、すべてのタスク履歴がジョブ履歴に含まれます。 falseの場合、ジョブ履歴のみが返されます。
  • 取得するジョブのステータス値。 使用可能な値の例:\\ ACCEPTED、IN_PROGRESS、FAILED、SUCCEEDED、CANCELING、CANCELED。
  • 最新から取得するジョブ履歴の数。 存在しない場合は、オブジェクトのすべてのジョブが返されます。
  • この値の前に開始時間を持つジョブを取得します。 使用可能な形式は、yyyy-MM-dd'T'HH:mm:ss.SZ、yyyy-MM-dd HH:mm:ss、yyyy-MM-ddです。

この操作のリクエスト本文がありません。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

成功した操作。
本文()
ルート・スキーマ: schema
Type: array
ソースを表示
ネストされたスキーマ: JobInformation
Type: object
ソースを表示
ネストされたスキーマ : jobTasks
Type: array
ソースを表示
ネストされたスキーマ: TaskInformation
Type: object
ソースを表示

403レスポンス

禁止(操作の権限がない、不明な理由によりリクエストが拒否されたなど)。
本文()
ルート・スキーマ: Error
Type: object
ソースを表示

404レスポンス

見つかりません。 リクエストされたリソースは見つかりませんでした。
本文()
ルート・スキーマ: Error
Type: object
ソースを表示

500レスポンス

内部サーバー・エラー。 サーバーで予期しない状態が発生したため、リクエストを実行できませんでした。
本文()
ルート・スキーマ: Error
Type: object
ソースを表示
先頭に戻る

例

この例では、特定のsequenceIDのジョブ実行の詳細な履歴を返します。 順序のオブジェクトIDは'john.smith@mycompany.com'.'MySalesSequences'で、Base64URLでエンコードされたsequenceID値があります: J2pvaG4uc21pdGhAbXljb21wYW55LmNvbScuJ015U2FsZXNTZXF1ZW5jZXMn。

cURLの例:

curl -i \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json' \
     --request GET 'https://<hostname>/api/20210901/catalog/sequences/J2pvaG4uc21pdGhAbXljb21wYW55LmNvbScuJ015U2FsZXNTZXF1ZW5jZXMn/history' \

この例では、シーケンスのすべての履歴を返します。

ノート: numberOfJobsパラメータを使用すると、返されるジョブの数を制限できます。 パラメータを省略するか0 ( numberOfJobs=0)に設定すると、すべてのジョブが返されます。

リクエスト本文の例

Not applicable.

レスポンス本文の例

[
    {
    "jobName":"'john.smith@mycompany.com'.'MySalesSequence: Enrich MySales Report'",
    "jobIdentifier":"1234ABCD5678EFGH9012IJKL3456MNOP",
    "jobStartTimestamp":"2024-06-06T21:23:47.0+0000",
    "jobExecutionStartTimestamp":"2024-06-06T21:24:02.0+0000",
    "jobStatus":"IN_PROGRESS",
    "jobRunType":"SEQUENCE",
    "jobQueuedDuration":"PT34.691S",
    "jobRunDuration":"PT19.691S",
    "jobOriginOfRequest":"Manual",
    "jobNumberOfTasks":"3",
    "jobTasks":[
        {"taskName":"DFLW : MySalesDataFlow",
        "taskStartTimestamp":"2024-06-06T21:24:09.0+0000",
        "taskEndTimestamp":"2024-06-06T21:24:14.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskDuration":"PT5S"},

        {"taskName":"DSET : MySalesDataSet 1",
        "taskStartTimestamp":"2024-06-06T21:24:14.0+0000",
        "taskStatus":"IN_PROGRESS",
        "taskSourceName":"'john.smith@mycompany.com'.'MySalesDataSet - Set 1'",
        "taskTargetName":"Data Set Storage",
        "taskAverageReadThroughput":"1220",
        "taskDuration":"PT7.691S"},

        {"taskName":"DSET : MySalesDataSet 2",
        "taskStatus":"ACCEPTED",
        "taskSourceName":"Internal Data Set Storage",
        "taskTargetName":"Data Set Storage",
        "taskDuration":"PT477141H24M21.691S"}]
    },
{"jobName":"'john.smith@mycompany.com'.'MySalesSequence: Enrich MySales Report'",
    "jobIdentifier":"2345ABCD6789EFGH0123IJKL4567MNOP",
    "jobStartTimestamp":"2024-04-17T15:19:47.0+0000",
    "jobExecutionStartTimestamp":"2024-04-17T15:20:04.0+0000",
    "jobEndTimestamp":"2024-04-17T15:20:28.0+0000",
    "jobStatus":"SUCCEEDED",
    "jobRunType":"SEQUENCE",
    "jobNumberOfSuccessfulRows":"144",
    "jobQueuedDuration":"PT41S",
    "jobRunDuration":"PT24S",
    "jobOriginOfRequest":"Manual",
    "jobNumberOfTasks":"3",
    "jobTasks":[
        {"taskName":"DFLW : MySalesDataFlow",
        "taskStartTimestamp":"2024-04-17T15:20:10.0+0000",
        "taskEndTimestamp":"2024-04-17T15:20:16.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskDuration":"PT6S"},
        
        {"taskName":"DSET : MySalesDataSet 1",
        "taskStartTimestamp":"2024-04-17T15:20:16.0+0000",
        "taskEndTimestamp":"2024-04-17T15:20:24.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskSourceName":"'john.smith@mycompany.com'.'MySalesDataSet - Set 1'",
        "taskTargetName":"Data Set Storage",
        "taskAverageReadThroughput":"1714",
        "taskDataSizeInBytes":"65536",
        "taskNumberOfSuccessfulRows":"72",
        "taskDuration":"PT8S"},
        
        {"taskName":"DSET : MySalesDataSet 2",
        "taskStartTimestamp":"2024-04-17T15:20:25.0+0000",
        "taskEndTimestamp":"2024-04-17T15:20:28.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskSourceName":"Internal Data Set Storage",
        "taskTargetName":"Data Set Storage",
        "taskAverageReadThroughput":"6545",
        "taskDataSizeInBytes":"13486",
        "taskNumberOfSuccessfulRows":"72",
        "taskDuration":"PT3S"}
        ]
    },
{"jobName":"'john.smith@mycompany.com'.'MySalesSequence: MySales Sequence Report'",
    "jobIdentifier":"3456ABCD7890EFGH1234IJKL5678MNOP",
    "jobStartTimestamp":"2024-04-15T22:47:47.0+0000",
    "jobExecutionStartTimestamp":"2024-04-15T22:48:03.0+0000",
    "jobEndTimestamp":"2024-04-15T22:48:24.0+0000",
    "jobStatus":"SUCCEEDED",
    "jobRunType":"SEQUENCE",
    "jobNumberOfSuccessfulRows":"144",
    "jobQueuedDuration":"PT37S",
    "jobRunDuration":"PT21S",
    "jobOriginOfRequest":"Manual",
    "jobNumberOfTasks":"3",
    "jobTasks":[
        {"taskName":"DFLW : MySalesDataFlow",
        "taskStartTimestamp":"2024-04-15T22:48:08.0+0000",
        "taskEndTimestamp":"2024-04-15T22:48:13.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskDuration":"PT5S"},

        {"taskName":"DSET : MySalesDataSet 1",
        "taskStartTimestamp":"2024-04-15T22:48:13.0+0000",
        "taskEndTimestamp":"2024-04-15T22:48:19.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskSourceName":"'john.smith@mycompany.com'.'MySalesDataSet - Set 1'",
        "taskTargetName":"Data Set Storage",
        "taskAverageReadThroughput":"1043",
        "taskDataSizeInBytes":"65536",
        "taskNumberOfSuccessfulRows":"72",
        "taskDuration":"PT6S"},

        {"taskName":"DSET : MySalesDataSet 2",
        "taskStartTimestamp":"2024-04-15T22:48:20.0+0000",
        "taskEndTimestamp":"2024-04-15T22:48:23.0+0000",
        "taskStatus":"SUCCEEDED",
        "taskSourceName":"Internal Data Set Storage",
        "taskTargetName":"Data Set Storage",
        "taskAverageReadThroughput":"5142",
        "taskDataSizeInBytes":"13486",
        "taskNumberOfSuccessfulRows":"72",
        "taskDuration":"PT3S"}
        ]
    }
]

cURLパラメータを使用した例:

特定の実行履歴を戻す場合は、1つ以上の問合せパラメータを適用して、ジョブ・ステータスまたは開始時間で結果をフィルタし、タスク履歴を除外して、返されるジョブ数を制限できます。 たとえば、特定の日付(2024-05-01)から成功したジョブのみを返し、タスク情報を除外できます。 

curl -i \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json' \
     --request GET 'https://<hostname>/api/20210901/catalog/sequences/J2pvaG4uc21pdGhAbXljb21wYW55LmNvbScuJ015U2FsZXNTZXF1ZW5jZXMn/history?jobStatus=SUCCEEDED&fromStartTime=2024-05-01&includeTasks=false'
先頭に戻る