Udostępnij za pośrednictwem

Fragment wersji 1 (wersja 1)

  • Artykuł

Uwaga

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

Get

Pobiera wycinki danych dla tabeli w fabryce danych.

Żądanie

Żądanie Get Slice 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}/tables/{TableName}/slices?start={StartDateTime}& end={EndDateTime}&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, którą chcesz znaleźć w tabeli.
TableName Tak Nazwa tabeli, którą chcesz wyciąć.
StartDateTime Tak Data i godzina rozpoczęcia wycinków.
EndDateTime Nie Data i godzina zakończenia wycinków. Wartość domyślna to 48 godzin po dacie rozpoczęcia.
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

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

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

Nazwa elementu Opis
SliceStatus Stan tego wycinka.
SliceState Stan wycinka.
RetryCount Liczba ponownych prób wycinków.
LongRetryCount Ile razy wycinki wykonałyby długie ponowienie próby.
StartDateTime Data i godzina rozpoczęcia tego wycinka
EndDateTime Data i godzina zakończenia tego wycinka.

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

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

Ustaw stan

Ustawia stan wycinków dla tabeli w fabryce danych.

Żądanie

Żądanie ustaw stan wycinka 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
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

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ę.
TableName Tak Nazwa tabeli, którą chcesz utworzyć.
StartDateTime Tak Data/godzina rozpoczęcia wycinków.
EndDateTime Tak Data/godzina zakończenia 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

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

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

Nazwa elementu Opis
NewSliceStatus Stan, który chcesz ustawić.
UpdateType Określa typ aktualizacji do wycinka.

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

Brak.

Przykładowe żądanie i odpowiedź

Przykładowy identyfikator URI:

  
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

Żą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: 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