Compartilhar via

Slice Run versão 1 (V1)

  • Artigo

Observação

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

Obter execução

Obtém execuções para uma fatia de dados de uma tabela em um data factory.

Solicitação

A solicitação Obter Execução 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}/sliceruns?start={StartDateTime}& 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 Nome da fábrica de dados em que você deseja localizar a tabela.
TableName Yes Nome da tabela que deseja localizar.
StartDateTime Yes A data e hora de início das 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 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": [  
    {  
        "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": {}  
    }  
    ]  
}

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

Nome do elemento Descrição
ID ID dessa execução.
ErrorMessage Qualquer mensagem de erro relacionada a essa execução. Se não ocorreu nenhum erro nessa execução, ela é null.
RetryCount O número indica quantas vezes as fatias seriam repetidas.
DataArtifactID Identificação da tabela.
TableName Nome da tabela.
PipelineID ID do pipeline.
PipelineName Nome do pipeline.
ActivityID ID dessa atividade.
ActivityName Nome dessa atividade.
ComputeClusterName Nome do cluster que é usado para calcular essa atividade. Geralmente, o nome do serviço vinculado relacionado.
Status Status atual dessa atividade.
ProcessingStartTime A hora de início do processo.
ProcessingEndTime A hora de término do processo.
BatchTime O tempo em lote para essa execução.
SliceStartTime A hora em que essa fatia está agendada para iniciar.
SliceEndTime A hora em que essa fatia está agendada para terminar.
TimeStamp A hora em que essa fatia realmente começa a funcionar.

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/sliceruns?startTime=2015-12-09T12: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 de 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

A resposta inclui o corpo XML a seguir.

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

Salvar log de execução

Baixa arquivos de log do processamento do HDInsight.

Solicitação

A solicitação Salvar Log 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}/runs/{RunID}/logInfo?start={StartDateTime}& 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.
RunID Yes A ID exclusiva da execução.
StartDateTime Yes A data e hora em que as fatias são iniciadas.
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) - 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 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

O corpo da resposta é um endereço de URI que aponta para as informações completas de log da execução.

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

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

Nome do elemento Descrição
StorageAccountName ID dessa execução.
RunID Primeira parte de seu RunID completo.
RunInfo Incluir a data e hora de início e a data e hora de término dessa execução.

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/test/runs/fb7cd921-ea00-4bb8-8cb3-77cdc28d5dd3_635536800000000000_635537664000000000_tabletest/logInfo?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: 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

A resposta inclui o corpo XML a seguir.

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