スライス実行バージョン 1 (V1)

[アーティクル]
02/07/2024

注意

このリファレンスドキュメントは、Azure Data Factory バージョン 1 (V1) に適用されます。

実行を取得する

データファクトリ内のテーブルのデータスライスの実行を取得します。

要求

実行の取得要求の構成は次のとおりです (HTTPS を推奨)。

HTTP 動詞	要求 URI	HTTP バージョン
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/tables/{TableName}/sliceruns?start={StartDateTime}&api-version={api-version}	HTTP/1.1

URI パラメーター

URI パラメーター	必須	説明
SubscriptionID	Yes	Azure のサブスクリプション ID。
ResourceGroupName	Yes	Azure Data Factory をホストするリソースグループの一意の名前。
DataFactoryName	Yes	テーブルを検索するデータファクトリの名前です。
TableName	Yes	検索するテーブルの名前。
StartDateTime	Yes	スライスが開始する日時。
Api-Version	Yes	この要求に使用されるプロトコルのバージョンを指定します。

要求ヘッダー

要求ヘッダーの説明を次の表に示します。

要求ヘッダー	必須	説明
x-ms-client-request-id	Yes	この要求の操作 ID。

要求本文

[なし] :

Response

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

状態コード

200 (OK) - 要求が正常に完了した場合。
400 (無効な要求) - 要求の本文に検証でエラーが出た場合。
404 (見つかりません) - サブスクリプションまたはリソースグループが存在しません。

レスポンスヘッダー

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー	説明
x-ms-request-id	現在の操作、生成されたサービスのための一意の識別子。
x-ms-ratelimit-remaining-subscription-writes	現在のサブスクリプションの残りの制限。
x-ms-correlation-request-id	要求のトレース相関 ID を指定します。エンドツーエンドの要求を Azure 全体で相互に関連付けられるように、リソースプロバイダーはこれを記録する必要があります。
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Date	サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。

応答本文

  
{  
    "value": [  
    {  
        "id": <ID>,  
        "errorMessage": <ErrorMessage>,  
        "dataArtifactId": <DataArtifactID>,  
        "tableName": <TableName>,  
        "pipelineId": <PipelineID>,  
        "pipelineName": <PipelineName>,  
        "activityId": <ActivityID>,  
        "activityName": <ActivityName>,  
        "computeClusterName": <ComputeClusterName>  
        "status": <Status>,  
        "processingStartTime": <ProcessingStartTime>,  
        "processingEndTime": <ProcessingEndTime>,  
        "batchTime": <BatchTime>,  
        "percentComplete": 100,  
        "dataSliceStart": <SliceStartTime>,  
        "dataSliceEnd": <SliceEndTime>,  
        "timestamp": <TimeStamp>  
        "retryAttempt": 0,  
        "type": "<Type of activity>",  
        "hasLogs": true,  
        "activityRunId": "<ActivityRunID>",  
         "properties": {},  
         "executionEvents": null,  
         "inputRunRecordReferences": null,  
         "outputRunRecordReferences": null,  
         "activityInputProperties": {}  
    }  
    ]  
}

応答本文の要素は次のとおりです。

要素名	説明
id	この実行の ID。
ErrorMessage	この実行に関連するエラーメッセージ。この実行でエラーが発生しなかった場合は、null です。
RetryCount	数字は、スライスが再試行される回数を示します。
DataArtifactID	テーブルの ID。
TableName	テーブルの名前。
PipelineID	パイプラインの ID。
PipelineName	パイプラインの名前。
ActivityID	このアクティビティの ID です。
ActivityName	このアクティビティの名前です。
ComputeClusterName	このアクティビティを計算するために使用されるクラスターの名前。通常は、関連するリンクされたサービスの名前です。
Status	このアクティビティの現在の状態。
ProcessingStartTime	プロセスの開始時刻を指定します。
ProcessingEndTime	プロセスの終了時刻を指定します。
BatchTime	この実行のバッチ処理の時間。
SliceStartTime	このスライスが開始する予定時刻を指定します。
SliceEndTime	このスライスが終了する予定時刻を指定します。
TimeStamp	このスライスが実際に動作を開始する時刻を指定します。

要求と応答の例

URI の例:

GET:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datasets/EmpSQLTable/sliceruns?startTime=2015-12-09T12:00:00.0000000&api-version=2015-10-01

要求は次のヘッダーと共に送信されます。

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

要求が送信された後、次の応答が返されます。

応答ヘッダー:

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799985  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:33:07 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

応答には、次の XML 本文が含まれます。

  
{  
  "value": [  
    {  
      "id": "b61bd003-8d96-4cff-a704-6d97619ff95c_000000000000000000_635852628000000000_EmpSQLTable",  
      "errorMessage": null,  
      "dataArtifactId": "376389aa-cef0-4418-8c80-4a8f2af3a84b",  
      "tableName": "EmpSQLTable",  
      "pipelineId": "c5326985-fd60-4f46-bbae-130d318759c6",  
      "pipelineName": "ADFTutorialPipeline",  
      "activityId": "5d130359-17e9-b0a6-65bc-4902bd2881e8",  
      "activityName": "CopyFromBlobToSQL",  
      "computeClusterName": null,  
      "status": "Succeeded",  
      "processingStartTime": "2016-02-22T22:53:18.0323409Z",  
      "processingEndTime": "2016-02-22T22:54:20.6254421Z",  
      "batchTime": "2015-12-09T13:00:00Z",  
      "percentComplete": 100,  
      "dataSliceStart": "2015-12-09T12:00:00Z",  
      "dataSliceEnd": "2015-12-09T13:00:00Z",  
      "timestamp": "2016-02-22T22:53:18.0323409Z",  
      "retryAttempt": 0,  
      "type": "Copy",  
      "hasLogs": false,  
      "activityRunId": "00000000-0000-0000-0000-000000000000",  
      "properties": {},  
      "executionEvents": null,  
      "inputRunRecordReferences": null,  
      "outputRunRecordReferences": null,  
      "activityInputProperties": {}  
    }  
  ]  
}

実行ログの保存

HDInsight 処理からログファイルをダウンロードします。

要求

ログの保存要求は次のように構成されます (HTTPS を推奨)。

HTTP 動詞	要求 URI	HTTP バージョン
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/runs/{RunID}/logInfo?start={StartDateTime}&api-version={api-version}	HTTP/1.1

URI パラメーター

URI パラメーター	必須	説明
SubscriptionID	Yes	Azure のサブスクリプション ID。
ResourceGroupName	Yes	Azure Data Factory をホストするリソースグループの一意の名前。
DataFactoryName	Yes	テーブルを作成するデータファクトリの名前。
RunID	Yes	実行の一意の ID。
StartDateTime	Yes	スライスを開始する日付と時刻。
Api-Version	Yes	この要求に使用されるプロトコルのバージョンを指定します。

要求ヘッダー

要求ヘッダーの説明を次の表に示します。

要求ヘッダー	必須	説明
x-ms-client-request-id	Yes	この要求の操作 ID。

要求本文

[なし] :

Response

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

状態コード

200 (OK) - 要求が正常に完了した場合。
400 (無効な要求) - 要求の本文に検証でエラーが出た場合。
404 (見つかりません) - サブスクリプションまたはリソースグループが存在しません。

レスポンスヘッダー

応答ヘッダー	説明
x-ms-request-id	現在の操作、生成されたサービスのための一意の識別子。
x-ms-ratelimit-remaining-subscription-writes	現在のサブスクリプションの残りの制限。
x-ms-correlation-request-id	要求のトレース相関 ID を指定します。リソースプロバイダーは、Azure 全体でエンドツーエンド要求を関連付けられるように、この ID をログに記録する必要があります。
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Date	サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。

応答本文

応答本文は、実行の完全なログ情報をポイントする URI アドレスです。

  
{  
    https://{StorageAccountName>.blob.core.windows.net/{RunID>?<RunInfo>   
}

応答本文の要素は次のとおりです。

要素名	説明
StorageAccountName	この実行の ID。
RunID	完全な RunID の最初のパート。
RunInfo	この実行の開始日時と終了日時が含まれます。

要求と応答の例

URI の例:

GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/runs/fb7cd921-ea00-4bb8-8cb3-77cdc28d5dd3_635536800000000000_635537664000000000_tabletest/logInfo?api-version=2015-10-01

要求は次のヘッダーと共に送信されます。

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

要求が送信された後、次の応答が返されます。

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799999  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:33:07 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

応答には、次の XML 本文が含まれます。

https://SampleTest.blob.core.windows.net/fb7cd921-ea00-4bb8-8cb3-77cdc28d5dd3?sv=2015-02-14&sr=c&sig=caUttHryqvL%2BaEntTWG4kIOsMpUkgM2EkD7nG2Aikqg%3D&st=2015-12-10T16%3A44%3A19Z&se=2015-12-10T18%3A44%3A19Z&sp=rl

Share via

スライス実行バージョン 1 (V1)

実行を取得する

要求

URI パラメーター

要求ヘッダー

要求本文

Response

状態コード

レスポンスヘッダー

応答本文

要求と応答の例

実行ログの保存

要求

URI パラメーター

要求ヘッダー

要求本文

Response

状態コード

レスポンスヘッダー

応答本文

要求と応答の例

その他のリソース

Share via

スライス実行バージョン 1 (V1)

実行を取得する

要求

URI パラメーター

要求ヘッダー

要求本文

Response

状態コード

レスポンス ヘッダー

応答本文

要求と応答の例

実行ログの保存

要求

URI パラメーター

要求ヘッダー

要求本文

Response

状態コード

レスポンス ヘッダー

応答本文

要求と応答の例

その他のリソース

レスポンスヘッダー

レスポンスヘッダー