Veri kümesi sürüm 1 (V1)

Makale
05/07/2024

Not

Bu başvuru belgeleri Azure Data Factory sürüm 1 (V1) için geçerlidir.

Oluşturma veya güncelleştirme

Yeni bir veri kümesi oluşturur veya mevcut bir veri kümesinin içeriğini güncelleştirir.

İstek

Veri Kümesi Oluştur veya Güncelleştir isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
PUT	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datasets/{DatasetName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubunun benzersiz adı.
DataFactoryName	Yes	Veri kümenizi oluşturmak istediğiniz veri fabrikasının adı.
Datasetname	Yes	Oluşturmak istediğiniz veri kümesinin adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

İstek gövdesi veri kümenizin türüne bağlıdır. Buradaki örnekte AzureBlob veri kümesi kullanılır.

İstek gövdesinin biçimi aşağıdaki gibidir.

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

JSON'daki özelliklerin açıklamaları için bkz. Azure Data Factory makalesindeki veri kümeleri.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - istek başarıyla tamamlandıysa.
202 (Kabul Edildi) - istek kabul edildiyse.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgi tarafından belirtilen koşul başarısız olduysa.
501 (Uygulanmadı) - doğrulama uygulanmadıysa

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için benzersiz bir tanımlayıcı, hizmet oluşturuldu.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir; Uçtan uca isteklerin Azure arasında ilişkilendirilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Konum	Oluşturmak veya almak istediğiniz nesnenin URI'sini.

Yanıt Gövdesi

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

JSON'daki özelliklerin açıklamaları için bkz. Azure Data Factory makalesindeki veri kümeleri.

Örnek İstek ve Yanıt

Örnek 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

İstek aşağıdaki üst bilgilerle gönderilir:

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

ve aşağıdaki gövdeye sahip:

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

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

Sil

Belirtilen veri kümesini siler.

İstek

Veri Kümesini Sil isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
DELETE	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/dataset/{DatasetName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubunun benzersiz adı.
DataFactoryName	Yes	Veri kümenizi silmek istediğiniz veri fabrikasının adı.
Datasetname	Yes	Silmek istediğiniz veri kümesinin adı
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - İstek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.
501 (Uygulanmadı) - doğrulama uygulanmadıysa

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için oluşturulan hizmet için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir; Uçtan uca isteklerin Azure arasında ilişkilendirilebilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.

Yanıt Gövdesi

Yok.

Örnek İstek ve Yanıt

Örnek 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

İstek aşağıdaki üst bilgilerle gönderilir.

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
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

Veri fabrikasındaki veri kümeleri hakkında bilgi alır.

İstek

Veri Kümesini Al isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datasets/{DatasetName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure data factory Hizmetinizi barındıran kaynak grubu için benzersiz bir ad.
DataFactoryName	Yes	Veri kümenizi almak istediğiniz veri fabrikasının adı.
Datasetname	Yes	Almak istediğiniz veri kümesinin adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için oluşturulan hizmet için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir. Uçtan uca isteklerin Azure arasında ilişkilendirilebilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.

Yanıt Gövdesi

Yanıt gövdesi veri kümenizin türüne bağlıdır. Bu örnekte bir AzureBlob veri kümesi kullanılır.

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

JSON'daki özelliklerin açıklamaları için Azure Data Factory veri kümeleri makalesine bakın.

Örnek İstek ve Yanıt

Örnek 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

İstek aşağıdaki üst bilgilerle gönderilir.

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

Üstbilgi:

  
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

Yanıt aşağıdaki XML gövdesini içerir.

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

Liste

veri fabrikasındaki tüm veri kümelerinin bilgilerini Listeler.

İstek

Veri Kümelerini Listele isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/datasets?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubu için benzersiz bir ad.
DataFactoryName	Yes	Veri kümenizi bulmak istediğiniz veri fabrikasının adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için oluşturulan hizmet için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir. Uçtan uca isteklerin Azure arasında ilişkilendirilebilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.

Yanıt Gövdesi

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

100'den fazla kayıt varsa nextLink ile aynı anda 100 kayıt alırsınız:

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

Sonraki kayıt kümesini almak için nextLink URL'sini kullanarak sonraki isteği gönderirsiniz. & nextLink URL'sinde çift tırnak ("") ile sarmalamanız gerekebilir. Aynı anda yalnızca 100 kayıt döndürülür.

JSON'daki özelliklerin açıklamaları için Azure Data Factory veri kümeleri makalesine bakın.

Örnek İstek ve Yanıt

Örnek 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

İstek aşağıdaki üst bilgilerle gönderilir.

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
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

Yanıt aşağıdaki XML gövdesini içerir.

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

Etkinlik Pencerelerini Listele

Bir veri kümesiyle ilişkili etkinlik penceresi örneklerinin ilk sayfasını ve sonraki sayfaya bağlantı Listeler.

İstek

Etkinlik Al penceresi isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
POST	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName/datasets/{DatasetName}/activitywindows?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubunun adı.
DataFactoryName	Yes	Veri fabrikasının adı.
Datasetname	Yes	Veri kümesinin adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Öğe Adı	Açıklama	Gerekli
Filtre	Azure Search filtresi dil bilgisi kullanılarak belirtilen etkinlik penceresi filtresi. Ayrıntılar için bkz. https://msdn.microsoft.com/library/azure/dn798921.aspx.	No
Orderby	Yanıtı belirtilen etkinlik penceresi özelliklerine göre sırala. Bu, virgülle ayrılmış özelliklerin listesidir. Örneğin: WindowStart, PercentComplete. Befault tarafından, sıra artan düzendir (ASC). Listenin azalan düzende sıralanmasını istiyorsanız DESC belirtin.	No
Üst	Listelenecek etkinlik pencerelerinin sayısı.	No
RunStart	Etkinlik penceresinin başlangıç saati çalıştırılır.	No
RunEnd	Etkinlik penceresinin bitiş saati çalıştırılır.	No
WindowStart	Başlangıç saati etkinlik penceresi.	No
Pencere Ucu	Etkinlik bitiş saati penceresi.	No
Windowstate	Etkinlik penceresinin durumu. Bu makalede belirtilen değerlerden biri olmalıdır.	No
WindowSubstate	Etkinlik penceresinin alt durumu. Bu makalede belirtilen değerlerden biri olmalıdır.	No

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - İstek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Description
x-ms-request-id	Geçerli işlem için benzersiz bir tanımlayıcı, hizmet oluşturuldu.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İsteğin izleme bağıntı kimliğini belirtir. Uçtan uca isteklerin Azure arasında ilişkilendirilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.

Yanıt Gövdesi

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

Örnek İstek ve Yanıt

Örnek 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

İstek aşağıdaki üst bilgiler ve gövde ile gönderilir:

Üstbilgi:

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

Vücut:

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

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
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

Yanıt aşağıdaki XML gövdesini içerir.

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

Sonuçların sonraki sayfasını almak için nextLink URL'sini kullanın.

Aracılığıyla paylaş

Veri kümesi sürüm 1 (V1)

Oluşturma veya güncelleştirme

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Sil

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Get

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Liste

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Etkinlik Pencerelerini Listele

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Ek kaynaklar