Compartir a través de

Segmento versión 1 (V1)

  • Artículo

Nota

Esta documentación de referencia se aplica a Azure Data Factory versión 1 (V1).

Get

Obtiene los segmentos de datos de una tabla de la factoría de datos.

Solicitud

La solicitud Obtener segmento 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}/slices?start={StartDateTime}& end={EndDateTime}&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 donde desea ubicar la tabla.
TableName Sí Nombre de la tabla que desea segmentar.
StartDateTime Sí La fecha y hora cuando se inician los segmentos.
EndDateTime No La fecha y hora cuando finalizan los segmentos. El valor predeterminado es de 48 horas después de la fecha y hora de inicio.
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 entre 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": [  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime1>.  
        "end": <EndDateTime1>  
    },  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime2>.  
        "end": <EndDateTime2>  
    },  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime3>.  
        "end": <EndDateTime3>  
    }  
    ]  
}

En la tabla siguiente se describen los elementos del cuerpo de respuesta.

Nombre del elemento Descripción
SliceStatus Estado de este segmento.
SliceState Estado del segmento.
RetryCount El número de veces que se reintentarán los segmentos.
LongRetryCount El número de veces que los segmentos realizarán un reintento largo.
StartDateTime La fecha y hora en que se inicia este segmento
EndDateTime La fecha y hora en que finaliza este segmento.

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/slices?start=2015-12-09T12:00:00.0000000&end=2015-12-09T14: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:

  
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": [  
    {  
      "status": "Ready",  
      "state": "Ready",  
      "retryCount": 0,  
      "longRetryCount": 0,  
      "statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",  
      "start": "2015-12-09T12:00:00Z",  
      "end": "2015-12-09T13:00:00Z"  
    },  
    {  
      "status": "Ready",  
      "state": "Ready",  
      "retryCount": 0,  
      "longRetryCount": 0,  
      "statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",  
      "start": "2015-12-09T13:00:00Z",  
      "end": "2015-12-09T14:00:00Z"  
    }  
  ]  
}

Establecimiento del estado

Establece el estado de los segmentos de una tabla de una factoría de datos.

Solicitud

La solicitud Establecer estado de segmento se puede construir de la siguiente manera (se recomienda HTTPS):

Verbo HTTP URI de solicitud Versión HTTP
PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/tables/{TableName}/slices/ setstatus?start={StartDateTime}&end={EndDateTime}&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.
TableName Sí Nombre de la tabla que desea crear.
StartDateTime Sí Datetime cuando se inician los segmentos.
EndDateTime Sí Datetime cuando finalizan 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 Requerido Descripción
x-ms-client-request-id Sí El identificador de operación de esta solicitud.

Cuerpo de la solicitud

  
{  
    "SliceStatus": <NewSliceStatus>,  
    "UpdateType": <UpdateType>  
}

En la tabla siguiente se describen los elementos del cuerpo de respuesta.

Nombre del elemento Descripción
NewSliceStatus El estado que desea establecer.
UpdateType Especifica el tipo de actualización del segmento.

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

Ninguno.

Solicitud y respuesta de ejemplo

URI de ejemplo:

  
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/tables/tabletest/slices/setstatus?start=2015-12-02T00:00:00.0000000&end=2015-12-02T01: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.

  
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