Dilim sürüm 1 (V1)
Not
Bu başvuru belgeleri Azure Data Factory sürüm 1 (V1) için geçerlidir.
Get
Veri fabrikasındaki bir tablonun veri dilimlerini alır.
İstek
Dilim 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}/tables/{TableName}/slices?start={StartDateTime}& end={EndDateTime}&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 | Tablonuzu bulmak istediğiniz veri fabrikasının adı. |
TableName | Yes | Dilimlemesini istediğiniz tablonun adı. |
StartDateTime | Yes | Dilimlerin başladığı tarih-saat. |
EndDateTime | No | Dilimlerin bittiği tarih-saat. Varsayılan değer, başlangıç tarihi-saatinden 48 saat sonradır. |
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, 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 | 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 | İ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": [
{
"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>
}
]
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
Öğe Adı | Açıklama |
---|---|
SliceStatus | Bu dilimin durumu. |
SliceState | Dilimin durumu. |
RetryCount | Dilimlerin yeniden deneme sayısı. |
LongRetryCount | Dilimlerin uzun bir yeniden deneme yapma sayısı. |
StartDateTime | Bu dilimin başladığı tarih-saat |
EndDateTime | Bu dilimin sona erdiğinde tarih-saat. |
Örnek İstek ve Yanıt
Örnek 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
İ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-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": [
{
"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"
}
]
}
Durumu ayarla
Veri fabrikasındaki bir tablonun dilimlerinin durumunu ayarlar.
İstek
Dilim Durumunu Ayarla 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}/tables/{TableName}/slices/ setstatus?start={StartDateTime}&end={EndDateTime}&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 | Tablonuzu oluşturmak istediğiniz veri fabrikasının adı. |
TableName | Yes | Oluşturmak istediğiniz tablonun adı. |
StartDateTime | Yes | Dilimlerin başladığı tarih saat. |
EndDateTime | Yes | Dilimlerin sona erdiğinde tarih saat. |
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
{
"SliceStatus": <NewSliceStatus>,
"UpdateType": <UpdateType>
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
Öğe Adı | Açıklama |
---|---|
NewSliceStatus | Ayarlamak istediğiniz durum. |
UpdateType | Dilim için güncelleştirme türünü belirtir. |
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.
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:
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
İ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