Ejecución de segmentos versión 1 (V1)
Nota
Esta documentación de referencia se aplica a Azure Data Factory versión 1 (V1).
Obtener ejecución
Obtiene las ejecuciones de un segmento de datos de una tabla en una factoría de datos.
Solicitud
La solicitud Obtener ejecución se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión 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 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos en la que desea ubicar la tabla. |
| TableName | Sí | Nombre de la tabla que desea ubicar. |
| StartDateTime | Sí | Datetime cuando se inician los segmentos. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | el identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud; el proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otro se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
{
"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": {}
}
]
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
| Nombre del elemento | Descripción |
|---|---|
| id | Identificador de esta ejecución. |
| ErrorMessage | Todo mensaje de error relacionado con esta ejecución. Si no se produjo ningún error en esta ejecución, sería un valor nulo. |
| RetryCount | El número indica cuántas veces se pueden reintentar los segmentos. |
| DataArtifactID | Id. de la tabla. |
| TableName | Nombre de la tabla. |
| PipelineID | Identificador de la canalización. |
| PipelineName | Nombre de la canalización. |
| Identificador de actividad | Identificador de esta actividad. |
| ActivityName | Nombre de esta actividad. |
| ComputeClusterName | Nombre del clúster que se usa para calcular esta actividad; normalmente es el nombre del servicio vinculado relacionado. |
| Estado | Estado actual de esta actividad. |
| ProcessingStartTime | La hora en que comienza el proceso. |
| ProcessingEndTime | La hora en que finaliza el proceso. |
| BatchTime | La hora por lotes para esta ejecución. |
| SliceStartTime | La hora en que está programado el inicio de este segmento. |
| SliceEndTime | La hora en que está programada la finalización de este segmento. |
| TimeStamp | La hora en que este segmento realmente comienza a funcionar. |
Solicitud y respuesta de ejemplo
URI de ejemplo:
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
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
Encabezado de respuesta:
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
La respuesta incluye el siguiente cuerpo 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": {}
}
]
}
Guardar el registro de ejecución
Descarga los archivos de registro del procesamiento de HDInsight.
Solicitud
La solicitud Guardar registro se puede construir de la siguiente manera (se recomienda HTTPS):
| Verbo HTTP | URI de solicitud | Versión 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 |
Parámetros de identificador URI
| Parámetro de URI | Obligatorio | Descripción |
|---|---|---|
| SubscriptionID | Sí | Su identificador de suscripción de Azure. |
| ResourceGroupName | Sí | Un nombre único para el grupo de recursos que hospeda su servicio de Factoría de datos de Azure. |
| DataFactoryName | Sí | Nombre de la factoría de datos en la que desea crear la tabla. |
| RunID | Sí | El identificador único de la ejecución. |
| StartDateTime | Sí | La fecha y hora cuando se inician los segmentos. |
| Api-Version | Sí | Especifica la versión del protocolo utilizado para realizar esta solicitud. |
Encabezados de solicitud
La tabla siguiente describe los encabezados de solicitud.
| Encabezado de la solicitud | Obligatorio | Descripción |
|---|---|---|
| x-ms-client-request-id | Sí | El identificador de operación de esta solicitud. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
200 (Correcto), si la solicitud se completó correctamente.
400 (Solicitud incorrecta), si el cuerpo de la solicitud no se puede validar.
404 (No encontrado), si la suscripción o el grupo de recursos no existe.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| x-ms-request-id | Identificador único de la operación o servicio actual generado. |
| x-ms-ratelimit-Remaining-Subscription-Writes | El límite restante para la suscripción actual. |
| x-ms-correlation-request-id | Especifica el identificador de la correlación de seguimiento para la solicitud. El proveedor de recursos debe registrar esto para que las solicitudes de un extremo a otros se puedan correlacionar a través de Azure. |
| x-ms-routing-request-id | Location+DateTime+correlation-request-ID |
| Fecha | Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta. |
Cuerpo de la respuesta
El cuerpo de la respuesta es una dirección URI que señala a la información de registro completa de la ejecución.
{
https://{StorageAccountName>.blob.core.windows.net/{RunID>?<RunInfo>
}
En la tabla siguiente se describen los elementos del cuerpo de respuesta.
| Nombre del elemento | Descripción |
|---|---|
| StorageAccountName | Identificador de esta ejecución. |
| RunID | Primera parte del valor RunID completo. |
| RunInfo | Incluye la fecha y hora de inicio y de finalización de esta ejecución. |
Solicitud y respuesta de ejemplo
URI de ejemplo:
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
La solicitud se envía con los encabezados siguientes.
x-ms-client-request-id : 00000000-1111-1111-1111-000000000000
Una vez enviada la solicitud, se devuelve la respuesta siguiente.
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
La respuesta incluye el siguiente cuerpo 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