Compartilhar via

Fatia versão 1 (V1)

  • Artigo

Observação

Esta documentação de referência se aplica a Azure Data Factory versão 1 (V1).

Get

Obtém fatias de dados para uma tabela no data factory.

Solicitação

A solicitação Obter Fatia pode ser construída da seguinte maneira (recomendado HTTPS):

Verbo HTTP URI da solicitação Versão 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 URI

Parâmetro URI Necessário Descrição
SubscriptionID Yes Sua ID da assinatura do Azure.
ResourceGroupName Yes Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure.
DataFactoryName Yes O nome da fábrica de dados em que você quer localizar sua tabela.
TableName Yes O nome da tabela que deseja dividir.
StartDateTime Yes A data e hora de início das fatias.
EndDateTime No A data e hora de término das fatias. O valor padrão é 48 horas após a data e hora de início.
Versão da API Yes Especifica a versão do protocolo usado para fazer essa solicitação.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho da solicitação Necessário Descrição
x-ms-client-request-id Yes A ID da operação para essa solicitação.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

  • 200 (OK) – quando a solicitação é concluída com êxito.

  • 400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.

  • 404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-request-id Um identificador exclusivo para a operação atual, serviço gerado.
x-ms-ratelimit-remaining-subscription-writes O limite restante da assinatura atual.
x-ms-correlation-request-id Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure.
x-ms-routing-request-id Location+DateTime+correlation-request-ID
Data Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Corpo da resposta

  
{  
    "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>  
    }  
    ]  
}

A tabela a seguir descreve os elementos do corpo da resposta.

Nome do elemento Descrição
SliceStatus Status dessa fatia.
SliceState Estado da fatia.
RetryCount O número de vezes de repetição das fatias.
LongRetryCount O número de vezes que as fatias fariam uma repetição longa.
StartDateTime A data e hora em que essa fatia é iniciada
EndDateTime A data e hora em que essa fatia termina.

Exemplo de solicitação e resposta

URI de exemplo:

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

A solicitação é enviada com os seguintes cabeçalhos.

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

Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.

Cabeçalho:

  
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

A resposta inclui o corpo XML a seguir.

  
{  
  "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"  
    }  
  ]  
}

Definir status

Define o status de fatias de uma tabela em um data factory.

Solicitação

A solicitação Definir Status da Fatia pode ser construída da seguinte maneira (recomendado HTTPS):

Verbo HTTP URI da solicitação Versão 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 URI

Parâmetro URI Necessário Descrição
SubscriptionID Yes Sua ID da assinatura do Azure.
ResourceGroupName Yes Um nome exclusivo para o grupo de recursos que hospeda sua fábrica de dados do Azure.
DataFactoryName Yes A fábrica de dados em que você deseja criar a tabela.
TableName Yes Nome da tabela que você deseja criar.
StartDateTime Yes A data e hora de início das fatias.
EndDateTime Yes A data e hora de encerrar as fatias.
Versão da API Yes Especifica a versão do protocolo usado para fazer essa solicitação.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho da solicitação Obrigatório Descrição
x-ms-client-request-id Yes A ID da operação para essa solicitação.

Corpo da solicitação

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

A tabela a seguir descreve os elementos do corpo da resposta.

Nome do elemento Descrição
NewSliceStatus O status que deseja definir.
UpdateType Especifica o tipo de atualização para a fatia.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

  • 200 (OK) - se a solicitação foi concluída com êxito.

  • 400 (Solicitação Incorreta) – quando o corpo da solicitação falha na validação.

  • 404 (Não Encontrado) – quando a assinatura ou grupo de recursos não existe.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-request-id Um identificador exclusivo para a operação atual, serviço gerado.
x-ms-ratelimit-remaining-subscription-writes O limite restante para a assinatura atual.
x-ms-correlation-request-id Especifica a ID de correlação de rastreamento para a solicitação. O provedor de recursos deve registrar isso para que as solicitações de ponta a ponta possam ser correlacionadas no Azure.
x-ms-routing-request-id Location+DateTime+correlation-request-ID
Data Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Corpo da resposta

Nenhum.

Exemplo de solicitação e resposta

URI de exemplo:

  
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

A solicitação é enviada com os seguintes cabeçalhos.

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

Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.

  
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