Zestaw danych w wersji 1 (wersja 1)

Artykuł
05/07/2024

Uwaga

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

Tworzenie lub aktualizowanie

Tworzy nowy zestaw danych lub aktualizuje zawartość istniejącego zestawu danych.

Żądanie

Żądanie tworzenia lub aktualizowania zestawu danych 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}/datasets/{DatasetName}?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 utworzyć zestaw danych.
Datasetname	Tak	Nazwa zestawu danych, który chcesz utworzyć.
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

Treść żądania zależy od typu zestawu danych. W tym przykładzie użyto zestawu danych AzureBlob.

Format treści żądania jest następujący.

{  
  "name": "MyDataset",  
  "properties": {  
    "structure": [  
      {  
        "name": "Column1",  
        "type": "String"  
      },  
      {  
        "name": "Column2",  
        "type": "String"  
      }  
    ],  
    "type": "<Dataset type>",  
    "linkedServiceName": "<Name of the linked service that contains the data>",  
    "typeProperties": {  
            "type specific property": "<value>",  
            "type specific property 2": "<value>"  
    },  
    "external": true,  
    "availability": {  
      "frequency": "<Hour/Day/etc...>",  
      "interval": <number>  
    }  
  }  
}

Zobacz artykuł Zestawy danych w Azure Data Factory, aby uzyskać opisy właściwości w formacie JSON.

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.
202 (Zaakceptowano) — jeśli żądanie zostało zaakceptowane.
400 (Nieprawidłowe żądanie) — jeśli treść żądania zakończy się niepowodzeniem walidacji.
404 (NotFound) — jeśli subskrypcja lub grupa zasobów nie istnieje.
412 (Warunek wstępny nie powiodło się) — jeśli warunek określony przez nagłówek If-Match zakończył się niepowodzeniem.
501 (Nie zaimplementowano) — jeśli weryfikacja nie została zaimplementowana

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ź.
Lokalizacja	Identyfikator URI obiektu, który chcesz utworzyć lub pobrać.

Treść odpowiedzi

{  
  "name": "InputDataset",  
  "id":  
"/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/  
<data factory name>/tables/InputDataset",  
    "type": "AzureBlob",  
    "linkedServiceName": "<Name of the Data Factory linked service that contains the data>",  
    "typeProperties": {  
            "type specific property": "<value>",  
            "type specific property 2": "<value>"  
    },  
    "availability": {  
      "frequency": "<Hour | Day etc...>",  
      "interval": <number>  
    },  
    "external": true,  
    "policy": {},  
    "id": "7c4495bf-f12b-46b6-a653-d4cda899c91c",  
    "createTime": "2016-02-06T00:41:05.2978434Z",  
    "provisioningState": "Succeeded"  
  }  
}

Zobacz artykuł Zestawy danych w Azure Data Factory, aby uzyskać opisy właściwości w formacie JSON.

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/datasets/datasettest?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

oraz z następującą treścią:

{  
  "name": "InputDataset",  
  "properties": {  
    "structure": [  
      {  
        "name": "FirstName",  
        "type": "String"  
      },  
      {  
        "name": "LastName",  
        "type": "String"  
      }  
    ],  
    "type": "AzureBlob",  
    "linkedServiceName": "StorageLinkedService",  
    "typeProperties": {  
      "folderPath": "adftutorial/",  
      "fileName": "emp.txt",  
      "format": {  
        "type": "TextFormat",  
        "columnDelimiter": ","  
      }  
    },  
    "external": true,  
    "availability": {  
      "frequency": "Hour",  
      "interval": 1  
    }  
  }  
}

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

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-0000-0000-0000-000000000000  
x-ms-ratelimit-remaining-subscription-reads: 14979  
x-ms-correlation-request-id   : 00000000-0000-0000-0000-000000000000  
x-ms-routing-request-id       : EASTUS:20160206T004111Z:00000000-0000-0000-0000-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Sat, 06 Feb 2016 00:41:10 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
  
Body:  
{  
  "name": "InputDataset",  
  "id":  
"/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/  
<name of data factory>/tables/InputDataset",  
  "properties": {  
    "structure": [  
      {  
        "name": "FirstName",  
        "type": "String"  
      },  
      {  
        "name": "LastName",  
        "type": "String"  
      }  
    ],  
    "published": false,  
    "type": "AzureBlob",  
    "linkedServiceName": "StorageLinkedService",  
    "typeProperties": {  
      "fileName": "emp.txt",  
      "folderPath": "adftutorial/",  
      "format": {  
        "type": "TextFormat",  
        "columnDelimiter": ","  
      }  
    },  
    "availability": {  
      "frequency": "Hour",  
      "interval": 1  
    },  
    "external": true,  
    "policy": {},  
    "id": "00000000-0000-0000-0000-000000000000",  
    "createTime": "2016-02-06T00:41:05.2978434Z",  
    "provisioningState": "Succeeded"  
  }  
}

Usuń

Usuwa określony zestaw danych.

Żądanie

Żądanie usuwania zestawu danych może zostać skonstruowane w następujący sposób (zalecane jest użycie protokołu HTTPS):

Czasownik HTTP	Identyfikator URI żądania	Wersja protokołu HTTP
DELETE	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/dataset/{DatasetName}?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 usunąć zestaw danych.
Datasetname	Tak	Nazwa zestawu danych, który chcesz usunąć
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.
412 (Niepowodzenie warunku wstępnego) — jeśli warunek określony przez nagłówek If-Match nie powiódł się.
501 (Nie zaimplementowano) — jeśli weryfikacja nie jest zaimplementowana

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:

DELETE: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/dataset/myds?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  
client-tracking-id            : 83

Get

Pobiera informacje o zestawach danych w fabryce danych.

Żądanie

Żądanie Get Dataset 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}/datasets/{DatasetName}?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 usługę Azure Data Factory.
DataFactoryName	Tak	Nazwa fabryki danych, w której chcesz pobrać zestaw danych.
Datasetname	Tak	Nazwa zestawu danych, który chcesz pobrać.
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.
412 (Niepowodzenie warunku wstępnego) — jeśli warunek określony przez nagłówek If-Match nie powiódł się.

Nagłówki odpowiedzi

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

Treść odpowiedzi zależy od typu zestawu danych. W tym przykładzie użyto zestawu danych AzureBlob.

{  
  "name": "InputDataset",  
  "id":  
"/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/  
<data factory name>/tables/InputDataset",  
    "type": "AzureBlob",  
    "linkedServiceName": "<Name of the Data Factory linked service that contains the data>",  
    "typeProperties": {  
            "type specific property": "<value>",  
            "type specific property 2": "<value>"  
    },  
    "availability": {  
      "frequency": "<Hour | Day etc...>",  
      "interval": <number>  
    },  
    "external": true,  
    "policy": {},  
    "id": "7c4495bf-f12b-46b6-a653-d4cda899c91c",  
    "createTime": "2016-02-06T00:41:05.2978434Z",  
    "provisioningState": "Succeeded"  
  }  
}

Zobacz artykuł Zestawy danych w Azure Data Factory, aby uzyskać opisy właściwości w formacie JSON.

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/dataset/InputDataset?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-reads: 14998  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : EASTUS:20160206T004938Z:00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Sat, 06 Feb 2016 00:49:37 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

Odpowiedź zawiera następującą treść XML.

{  
  "name": "InputDataset",  
  "id":  
"/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/{data factory name>/tables/InputDataset",  
  "properties": {  
    "structure": [  
      {  
        "name": "FirstName",  
        "type": "String"  
      },  
      {  
        "name": "LastName",  
        "type": "String"  
      }  
    ],  
    "published": false,  
    "type": "AzureBlob",  
    "linkedServiceName": "StorageLinkedService",  
    "typeProperties": {  
      "fileName": "emp.txt",  
      "folderPath": "adftutorial/",  
      "format": {  
        "type": "TextFormat",  
        "columnDelimiter": ","  
      }  
    },  
    "availability": {  
      "frequency": "Hour",  
      "interval": 1  
    },  
    "external": true,  
    "policy": {},  
    "id": "00000000-1111-1111-1111-000000000000",  
    "createTime": "2016-02-06T00:41:05.2978434Z",  
    "provisioningState": "Succeeded"  
  }  
}

Lista

Listy informacje o wszystkich zestawach danych w fabryce danych.

Żądanie

Żądanie List Datasets (Lista zestawów danych) może zostać 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}/datasets?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, którą chcesz znaleźć w zestawie danych.
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 zakoń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.
412 (Warunek wstępny nie powiodło się) — jeśli warunek określony przez nagłówek If-Match zakończył się niepowodzeniem.

Nagłówki odpowiedzi

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": [  
    {  
      "name": "Name of the dataset",  
      "id":  
"/subscriptions/{Subscription ID>/resourcegroups/{Resource Group Name>/providers/Microsoft.DataFactory/datafactories/  
<Data Factory Name>/tables/{datasetname>",  
      "properties": {  
        "published": false,  
        "type": "Type of the dataset",  
        "typeProperties": {},  
        "id": "00000000-0000-0000-0000-000000000000",  
        "createTime": "2016-02-22T20:19:27.250261Z",  
        "provisioningState": "Succeeded"  
      }  
    },  
    {  
      "name": "Name of the dataset",  
      "id":  
"/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/  
<data factory name>/tables/{datasetname>",  
      "properties": {  
        "published": false,  
        "type": "Type of the dataset",  
        "typeProperties": {},  
        "id": "11111111-111-1111-1111-1111111111111",  
        "createTime": "2016-02-22T21:43:50.3713029Z",  
        "provisioningState": "Succeeded"  
      }  
    }  
  ]  
}

Jeśli istnieje więcej niż 100 rekordów, otrzymasz jednocześnie 100 rekordów za pomocą polecenia nextLink:

{
  "value": [
    {
      "name": "AzureBlobInput99",
      "id": "/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/ADFCopyTutorialDF/datasets/AzureBlobInput99",
      "properties": {
        "published": false,
        "type": "AzureBlob",
        "linkedServiceName": "AzureStorageLinkedService",
        "typeProperties": {},
        "id": "11111111-111-1111-1111-1111111111111",
        "createTime": "2016-08-27T01:59:21.5963602Z",
        "provisioningState": "Succeeded"
	   }
    }, 
    {
      "name": "AzureBlobInput100",
      "id": "/subscriptions/{subscription ID>/resourcegroups/{resource group name>/providers/Microsoft.DataFactory/datafactories/ADFCopyTutorialDF/datasets/AzureBlobInput100",
      "properties": {
        "published": false,
        "type": "AzureBlob",
        "linkedServiceName": "AzureStorageLinkedService",
        "typeProperties": {},
        "id": "11111111-111-1111-1111-1111111111111",
        "createTime": "2016-08-17T18:38:04.695873Z",
        "provisioningState": "Succeeded"
      }
	 }
  ],
  "nextLink": "https://management.azure.com/subscriptions/{subscription ID>/resourcegroups/{Resource group name>/providers/Microsoft.DataFactory/datafactories/{data factory name>/datasets?api-version=2015-10-01&%24skipToken=MSExNiFSR0YwWVVGeWRHbG1ZV04wCjEhNTIhUkVGZlpUSXlaR1UyTXpndFpURTJNeTAwWXpZNUxUaGhNR0l0Wm1VMU1ETmpOakF4T0RObA%3d%3d"
}

Następne żądanie jest wysyłane przy użyciu adresu URL nextLink , aby pobrać następny zestaw rekordów. Może być konieczne opakowywanie & z podwójnymi cudzysłowami ("") w następnym adresie URL linku. Tylko 100 rekordów jest zwracanych jednocześnie.

Zobacz artykuł Zestawy danych w Azure Data Factory, aby uzyskać opisy właściwości w formacie JSON.

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/datasets?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-reads: 14999  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : EASTUS:20160206T191716Z:00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Sat, 06 Feb 2016 19:17:15 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

Odpowiedź zawiera następującą treść XML.

{  
  "value": [  
    {  
      "name": "EmpTableFromBlob",  
      "id":  
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/  
SPRestDataFactory/tables/EmpTableFromBlob",  
      "properties": {  
        "published": false,  
        "type": "AzureBlob",  
        "typeProperties": {},  
        "id": "35555f2c-2cfe-48f4-86a8-bce7a3f1d1bd",  
        "createTime": "2016-02-22T20:19:27.250261Z",  
        "provisioningState": "Succeeded"  
      }  
    },  
    {  
      "name": "EmpSQLTable",  
      "id":  
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/  
SPRestDataFactory/tables/EmpSQLTable",  
      "properties": {  
        "published": false,  
        "type": "AzureSqlTable",  
        "typeProperties": {},  
        "id": "376389aa-cef0-4418-8c80-4a8f2af3a84b",  
        "createTime": "2016-02-22T21:43:50.3713029Z",  
        "provisioningState": "Succeeded"  
      }  
    }  
  ]  
}

Wyświetlanie listy działań w systemie Windows

Listy pierwszą stronę wystąpień okna działań skojarzonych z zestawem danych wraz z linkiem do następnej strony.

Żądanie

Żądanie okna Pobierz działanie może zostać skonstruowane w następujący sposób (zalecane jest użycie protokołu HTTPS):

Czasownik HTTP	Identyfikator URI żądania	Wersja protokołu HTTP
POST	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName/datasets/{DatasetName}/activitywindows?api-version={api-version}	HTTP/1.1

Parametry identyfikatora URI

Parametr identyfikatora URI	Wymagane	Opis
Subscriptionid	Tak	Identyfikator subskrypcji platformy Azure.
ResourceGroupName	Tak	Nazwa grupy zasobów, która hostuje fabrykę danych Platformy Azure.
DataFactoryName	Tak	Nazwa fabryki danych.
Datasetname	Tak	Nazwa zestawu danych.
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

Nazwa elementu	Opis	Wymagane
Filtr	Filtr okna działania określony przy użyciu gramatyki filtru usługi Azure Search. Aby uzyskać szczegółowe informacje, zobacz opis funkcji https://msdn.microsoft.com/library/azure/dn798921.aspx.	Nie
Orderby	Kolejność odpowiedzi według określonych właściwości okna działania. Jest to lista właściwości rozdzielonych przecinkami. Na przykład: WindowStart, PercentComplete. Według programu befault kolejność jest kolejnością rosnącą (ASC). Określ DESC, jeśli chcesz, aby lista ma być uporządkowana w kolejności malejącej.	Nie
Pierwsze	Liczba okien działań, które mają być wyświetlane.	Nie
RunStart	Godzina rozpoczęcia uruchomienia okna działania.	Nie
RunEnd	Godzina zakończenia uruchomienia okna działania.	Nie
OknoStart	Okno działania czasu rozpoczęcia.	Nie
WindowEnd	Godzina zakończenia okna działania.	Nie
Windowstate	Stan okna działania. Musi być jedną z wartości określonych w tym artykule.	Nie
WindowSubstate	Podstan okna działania. Musi być jedną z wartości określonych w tym artykule.	Nie

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

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": {  
    "activityWindows": [  
      {  
        "resourceGroupName": "<resource group name>",  
        "dataFactoryName": "<data factory name>",  
        "pipelineName": "<pipeline name>",  
        "activityName": "<Pipeline activity name.>",  
        "linkedServiceName": "<linked service name>",  
        "activityType": "<The activity type>",  
        "runAttempts": "<Number of activity run attempts.>",  
        "runStart": "<start time of the last run>",  
        "runEnd": "<end time of the last run>",  
        "duration": "<duration of the activity window>",  
        "percentComplete": "<percent completion of activity window>",  
        "windowStart": "<window start time>",  
        "windowEnd": "<window end time>",  
        "windowState": "<window state>",  
        "windowSubstate": "<window substate>",  
        "inputDatasets": "[<input dataset names>]",  
        "outputDatasets": [  
          "<output dataset names>"  
        ],  
        "inputDatasetIds":["<input dataset ids>"],  
        "outputDatasetIds": [  
          "<output dataset ids>" 
        ]  
      }  
    ],  
    "lastUpdate":"<The approximate time for the last activity windows>",  
    "aggregates": {}  
  },  
    "nextLink": "<Link to next page>"  
}

Przykładowe żądanie i odpowiedź

Przykładowy identyfikator URI:

POST:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/dfName/datasets/dsName/activitywindows?api-version=2015-10-01

Żądanie jest wysyłane z następującymi nagłówkami i treścią:

Nagłówka:

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

Ciała:

{
  "top": 5,
  "windowState": "Failed",
  "filter": "RunAttempts ge 1"
}

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

Odpowiedź zawiera następującą treść XML.

{
  "value": {
    "activityWindows": [
      {
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DP_WikipediaSamplePipeline",
        "activityName": "BlobToSqlCopyActivity",
        "linkedServiceName": "HDILinkedService",
        "activityType": "Copy",
        "runAttempts": 2,
        "runStart": "2016-11-18T20:16:43.149Z",
        "runEnd": "2016-11-18T20:20:06.517Z",
        "duration": "00:03:23.3680000",
        "percentComplete": 50,
        "windowStart": "2016-11-18T19:00:00Z",
        "windowEnd": "2016-11-18T20:00:00Z",
        "windowState": "Failed",
        "windowSubstate": "",
        "inputDatasets": [
          "DA_CuratedWikiData"
        ],
        "outputDatasets": [
          "DA_WikiAggregatedData"
        ],
        "inputDatasetIds": [
          "b7707e71-2bf8-4596-94c7-90676d67bb3d"
        ],
        "outputDatasetIds": [
          "5aee09bb-ec37-4c3e-b8c3-a974741769b4"
        ]
      },
      {
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DP_WikipediaSamplePipeline",
        "activityName": "BlobToSqlCopyActivity",
        "linkedServiceName": "HDILinkedService",
        "activityType": "Copy",
        "runAttempts": 2,
        "runStart": "2016-11-18T20:43:59.716Z",
        "runEnd": "2016-11-18T20:47:27.827Z",
        "duration": "00:03:28.1110000",
        "percentComplete": 50,
        "windowStart": "2016-11-18T15:00:00Z",
        "windowEnd": "2016-11-18T16:00:00Z",
        "windowState": "Failed",
        "windowSubstate": "",
        "inputDatasets": [
          "DA_CuratedWikiData"
        ],
        "outputDatasets": [
          "DA_WikiAggregatedData"
        ],
        "inputDatasetIds": [
          "b7707e71-2bf8-4596-94c7-90676d67bb3d"
        ],
        "outputDatasetIds": [
          "5aee09bb-ec37-4c3e-b8c3-a974741769b4"
        ]
      },
      {
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DP_WikipediaSamplePipeline",
        "activityName": "BlobToSqlCopyActivity",
        "linkedServiceName": "HDILinkedService",
        "activityType": "Copy",
        "runAttempts": 2,
        "runStart": "2016-11-18T20:50:54.688Z",
        "runEnd": "2016-11-18T20:54:19.826Z",
        "duration": "00:03:25.1370000",
        "percentComplete": 50,
        "windowStart": "2016-11-18T14:00:00Z",
        "windowEnd": "2016-11-18T15:00:00Z",
        "windowState": "Failed",
        "windowSubstate": "",
        "inputDatasets": [
          "DA_CuratedWikiData"
        ],
        "outputDatasets": [
          "DA_WikiAggregatedData"
        ],
        "inputDatasetIds": [
          "b7707e71-2bf8-4596-94c7-90676d67bb3d"
        ],
        "outputDatasetIds": [
          "5aee09bb-ec37-4c3e-b8c3-a974741769b4"
        ]
      },
      {
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DP_WikipediaSamplePipeline",
        "activityName": "BlobToSqlCopyActivity",
        "linkedServiceName": "HDILinkedService",
        "activityType": "Copy",
        "runAttempts": 2,
        "runStart": "2016-11-18T20:57:45.579Z",
        "runEnd": "2016-11-18T21:01:09.939Z",
        "duration": "00:03:24.3590000",
        "percentComplete": 50,
        "windowStart": "2016-11-18T13:00:00Z",
        "windowEnd": "2016-11-18T14:00:00Z",
        "windowState": "Failed",
        "windowSubstate": "",
        "inputDatasets": [
          "DA_CuratedWikiData"
        ],
        "outputDatasets": [
          "DA_WikiAggregatedData"
        ],
        "inputDatasetIds": [
          "b7707e71-2bf8-4596-94c7-90676d67bb3d"
        ],
        "outputDatasetIds": [
          "5aee09bb-ec37-4c3e-b8c3-a974741769b4"
        ]
      },
      {
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DP_WikipediaSamplePipeline",
        "activityName": "BlobToSqlCopyActivity",
        "linkedServiceName": "HDILinkedService",
        "activityType": "Copy",
        "runAttempts": 2,
        "runStart": "2016-11-18T21:11:26.944Z",
        "runEnd": "2016-11-18T21:14:52.082Z",
        "duration": "00:03:25.1380000",
        "percentComplete": 50,
        "windowStart": "2016-11-18T20:00:00Z",
        "windowEnd": "2016-11-18T21:00:00Z",
        "windowState": "Failed",
        "windowSubstate": "",
        "inputDatasets": [
          "DA_CuratedWikiData"
        ],
        "outputDatasets": [
          "DA_WikiAggregatedData"
        ],
        "inputDatasetIds": [
          "b7707e71-2bf8-4596-94c7-90676d67bb3d"
        ],
        "outputDatasetIds": [
          "5aee09bb-ec37-4c3e-b8c3-a974741769b4"
        ]
      }
    ],
    "lastUpdate": "2016-11-18T13:29:28.4180094-08:00",
    "aggregates": {}
  },  
    "nextLink": "https://localhost:86/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName/datafactories/dfName/datasets/dsName/activitywindows/skip=FG154H?ApiVerion01012015"
}

Użyj adresu URL nextLink, aby uzyskać następną stronę wyników.

Udostępnij za pośrednictwem

Zestaw danych w wersji 1 (wersja 1)

Tworzenie lub aktualizowanie

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Usuń

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Get

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Lista

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Wyświetlanie listy działań w systemie Windows

Żądanie

Parametry identyfikatora URI

Nagłówki żądań

Treść żądania

Reakcja

Kod stanu

Nagłówki odpowiedzi

Treść odpowiedzi

Przykładowe żądanie i odpowiedź

Dodatkowe zasoby