Uruchamianie wycinka w wersji 1 (wersja 1)

Artykuł
05/07/2024

Uwaga

Ta dokumentacja referencyjna dotyczy Azure Data Factory wersji 1 (V1).

Uruchamianie

Pobiera przebiegi dla wycinka danych tabeli w fabryce danych.

Żądanie

Żądanie Get Run można skonstruować w następujący sposób (zalecane jest użycie protokołu HTTPS):

Czasownik HTTP	Identyfikator URI żądania	Wersja protokołu 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

Parametry identyfikatora URI

Parametr identyfikatora URI	Wymagane	Opis
Subscriptionid	Tak	Identyfikator subskrypcji platformy Azure.
ResourceGroupName	Tak	Unikatowa nazwa grupy zasobów hostujących fabrykę danych Platformy Azure.
DataFactoryName	Tak	Nazwa fabryki danych, w której chcesz znaleźć tabelę.
TableName	Tak	Nazwa tabeli, którą chcesz znaleźć.
StartDateTime	Tak	Data/godzina rozpoczęcia wycinków.
Api-Version	Tak	Określa wersję protokołu używanego do wykonania tego żądania.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Wymagane	Opis
x-ms-client-request-id	Tak	identyfikator operacji dla tego żądania.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

200 (OK) — jeśli żądanie zostało ukończone pomyślnie.
400 (Nieprawidłowe żądanie) — jeśli treść żądania zakończy się niepowodzeniem walidacji.
404 (NotFound) — jeśli subskrypcja lub grupa zasobów nie istnieje.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Unikatowy identyfikator bieżącej operacji wygenerowanej przez usługę.
x-ms-ratelimit-remaining-subscription-writes	Pozostały limit dla bieżącej subskrypcji.
x-ms-correlation-request-id	Określa identyfikator korelacji śledzenia dla żądania; dostawca zasobów musi to zarejestrować , aby żądania kompleksowe mogły być skorelowane na platformie Azure.
x-ms-routing-request-id	Lokalizacja+Data/godzina+identyfikator-żądania-korelacji
Date	Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, w której zainicjowano odpowiedź.

Treść odpowiedzi

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

W poniższej tabeli opisano elementy treści odpowiedzi.

Nazwa elementu	Opis
ID (Identyfikator)	Identyfikator tego przebiegu.
ErrorMessage	Dowolny komunikat o błędzie związany z tym uruchomieniem. Jeśli w tym przebiegu nie wystąpiły żadne błędy, będzie to miało wartość null.
RetryCount	Liczba wskazuje, ile razy wycinki zostaną ponowione.
DataArtifactID	Identyfikator tabeli.
TableName	Nazwa tabeli.
Identyfikator potoku	Identyfikator potoku.
Nazwa potoku	Nazwa potoku.
ActivityID	Identyfikator tego działania.
ActivityName	Nazwa tego działania.
ComputeClusterName	Nazwa klastra używanego do obliczenia tego działania, zwykle nazwa powiązanej połączonej usługi.
Stan	Bieżący stan tego działania.
ProcessingStartTime	Czas rozpoczęcia procesu.
ProcessingEndTime	Czas zakończenia procesu.
BatchTime	Czas wsadowy dla tego przebiegu.
SliceStartTime	Godzina rozpoczęcia tego wycinka.
SliceEndTime	Czas zakończenia tego wycinka.
Znacznik czasu	Czas, kiedy ten wycinek rzeczywiście zaczyna działać.

Przykładowe żądanie i odpowiedź

Przykładowy identyfikator URI:

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

Żądanie jest wysyłane z następującymi nagłówkami.

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

Po wysłaniu żądania zostanie zwrócona następująca odpowiedź.

Nagłówek odpowiedzi:

  
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

Odpowiedź zawiera następującą treść 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": {}  
    }  
  ]  
}

Zapisywanie dziennika uruchamiania

Pobiera pliki dziennika z przetwarzania usługi HDInsight.

Żądanie

Żądanie zapisywania dziennika może być skonstruowane w następujący sposób (zalecane jest użycie protokołu HTTPS):

Czasownik HTTP	Identyfikator URI żądania	Wersja PROTOKOŁU 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

Parametry identyfikatora URI

Parametr identyfikatora URI	Wymagane	Opis
Subscriptionid	Tak	Identyfikator subskrypcji platformy Azure.
ResourceGroupName	Tak	Unikatowa nazwa grupy zasobów, która hostuje fabrykę danych Platformy Azure.
DataFactoryName	Tak	Nazwa fabryki danych, w której chcesz utworzyć tabelę.
Identyfikator przebiegu	Tak	Unikatowy identyfikator przebiegu.
StartDateTime	Tak	Data i godzina rozpoczęcia wycinków.
Api-Version	Tak	Określa wersję protokołu używanego do wykonania tego żądania.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Wymagane	Opis
x-ms-client-request-id	Tak	Identyfikator operacji dla tego żądania.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

200 (OK) — jeśli żądanie zostało ukończone pomyślnie.
400 (Nieprawidłowe żądanie) — jeśli treść żądania zakończy się niepowodzeniem walidacji.
404 (NotFound) — jeśli subskrypcja lub grupa zasobów nie istnieje.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Unikatowy identyfikator bieżącej operacji wygenerowany przez usługę.
x-ms-ratelimit-remaining-subscription-writes	Pozostały limit dla bieżącej subskrypcji.
x-ms-correlation-request-id	Określa identyfikator korelacji śledzenia dla żądania. Dostawca zasobów musi to zarejestrować, aby żądania kompleksowe mogły być skorelowane na platformie Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Date	Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, o której zainicjowano odpowiedź.

Treść odpowiedzi

Treść odpowiedzi to adres URI wskazujący pełne informacje dziennika przebiegu.

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

W poniższej tabeli opisano elementy treści odpowiedzi.

Nazwa elementu	Opis
StorageAccountName	Identyfikator tego przebiegu.
Identyfikator przebiegu	Pierwsza część pełnego identyfikatora RunID.
Runinfo	Uwzględnij datę rozpoczęcia i godzinę zakończenia tego przebiegu.

Przykładowe żądanie i odpowiedź

Przykładowy identyfikator URI:

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

Żądanie jest wysyłane z następującymi nagłówkami.

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

Po wysłaniu żądania zostanie zwrócona następująca odpowiedź.

  
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

Odpowiedź zawiera następującą treść 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

Udostępnij za pośrednictwem

Uruchamianie wycinka w wersji 1 (wersja 1)

Uruchamianie

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Zapisywanie dziennika uruchamiania

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Dodatkowe zasoby