Partilhar via

Segmentação de dados versão 1 (V1)

  • Artigo

Nota

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

Get

Obtém setores de dados para uma tabela numa fábrica de dados.

Pedir

O pedido Obter Setor pode ser construído da seguinte forma (é recomendado HTTPS):

Verbo HTTP URI do pedido 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 do URI

Parâmetro URI Obrigatório Descrição
ID da Subscrição Yes O seu ID de subscrição do Azure.
ResourceGroupName Yes Um nome exclusivo para o grupo de recursos que aloja a fábrica de dados do Azure.
DataFactoryName Yes Nome da fábrica de dados que pretende localizar a sua tabela.
TableName Yes Nome da tabela que pretende segmentar.
DataHoraDeInício Yes A data-hora em que os setores são iniciados.
DataHoraDeFim No A data-hora em que os setores terminam. O valor predefinido é 48 horas após a data e hora de início.
Api-Version Yes Especifica a versão do protocolo utilizado para fazer este pedido.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Obrigatório Descrição
x-ms-client-request-id Yes O ID da operação para este pedido.

Corpo do Pedido

Nenhum.

Resposta

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

Código de Estado

  • 200 (OK) – se o pedido tiver sido concluído com êxito.

  • 400 (Pedido Incorreto) – se o corpo do pedido falhar na validação.

  • 404 (NotFound) – se a subscrição ou o grupo de recursos não existir.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão 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 subscrição atual.
x-ms-correlation-request-id Especifica o ID de correlação de rastreio do pedido. O fornecedor de recursos tem de registar isto para que os pedidos ponto a ponto possam ser correlacionados no Azure.
x-ms-routing-request-id Location+DateTime+correlation-request-ID
Date 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 seguinte descreve os elementos do corpo da resposta.

Nome do Elemento Descrição
Segmentação de Dados Estado deste setor.
SliceState Estado do setor.
RetryCount O número de vezes que os setores repetiriam.
LongRetryCount O número de vezes que os setores fazem uma repetição longa.
DataHoraDeInício A data-hora em que este setor é iniciado
DataHoraDeFim A data-hora em que este setor termina.

Pedido e Resposta de Exemplo

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

O pedido é enviado com os seguintes cabeçalhos.

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

Depois de o pedido ter sido enviado, é devolvida a seguinte resposta.

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 seguinte corpo 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"  
    }  
  ]  
}

Definir estado

Define o estado dos setores de uma tabela numa fábrica de dados.

Pedir

O pedido Definir Estado do Setor pode ser construído da seguinte forma (é recomendado HTTPS):

Verbo HTTP URI do pedido 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 do URI

Parâmetro URI Obrigatório Descrição
ID da Subscrição Yes O seu ID de subscrição do Azure.
ResourceGroupName Yes Um nome exclusivo para o grupo de recursos que aloja a fábrica de dados do Azure.
DataFactoryName Yes Nome da fábrica de dados na qual pretende criar a tabela.
TableName Yes Nome da tabela que pretende criar.
DataHoraDeInício Yes O datetime quando os setores começam.
DataHoraDeFim Yes O datetime quando os setores terminam.
Api-Version Yes Especifica a versão do protocolo utilizado para fazer este pedido.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Necessário Descrição
x-ms-client-request-id Yes O ID da operação para este pedido.

Corpo do Pedido

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

A tabela seguinte descreve os elementos do corpo da resposta.

Nome do Elemento Descrição
NewSliceStatus O estado que pretende definir.
UpdateType Especifica o tipo de atualização para o setor.

Resposta

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

Código de Estado

  • 200 (OK) – se o pedido tiver sido concluído com êxito.

  • 400 (Pedido Incorreto) – se o corpo do pedido falhar na validação.

  • 404 (NotFound) – se a subscrição ou o grupo de recursos não existir.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão 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 subscrição atual.
x-ms-correlation-request-id Especifica o ID de correlação de rastreio do pedido. O fornecedor de recursos tem de registar isto para que os pedidos ponto a ponto possam ser correlacionados no Azure.
x-ms-routing-request-id Location+DateTime+correlation-request-ID
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Corpo da Resposta

Nenhum.

Pedido e Resposta de Exemplo

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

O pedido é enviado com os seguintes cabeçalhos.

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

Depois de o pedido ter sido enviado, é devolvida a seguinte resposta.

  
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