Datasets - Refresh Dataset

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

çalışma alanımbelirtilen veri kümesi için yenileme tetikler. gelişmiş yenileme tetiklenmesi için notifyOption dışında bir istek yükü ayarlanmış olması gerekir.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlama

• Paylaşılan kapasiteler için, zamanlanmış yenileme kullanılarak yürütülen yenilemeler de dahil olmak üzere günde en fazla sekiz istek başlatılabilir.
• Paylaşılan kapasiteler için, istek gövdesinde yalnızca notifyOption belirtilebilir.
• Paylaşılan kapasiteler için gelişmiş yenileme desteklenmez.
• İyileştirilmiş yenileme için notifyOption gerekli değildir ve istek gövdesinden dışlanmalıdır. Ancak, notifyOption dışında bir veya daha fazla parametre gereklidir.
• Premium kapasiteler için günlük maksimum istek sayısı yalnızca kapasitedeki kullanılabilir kaynaklarla sınırlıdır. Kullanılabilir kaynaklar aşırı yüklenmişse, yükleme azaltılana kadar yenilemeler kısıtlanır. Azaltma 1 saati aşarsa yenileme başarısız olur.
  
  

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
notifyOption	True	NotifyOption	Posta bildirim seçenekleri. Bu parametre, bir hizmet sorumlusuyla yapılan gelişmiş yenilemeler veya API işlemleri için geçerli değildir.
applyRefreshPolicy		boolean	İlkenin uygulanılıp uygulanmadığını belirleme
commitMode		DatasetCommitMode	Nesnelerin toplu olarak mı yoksa yalnızca tamamlandığında mı işleneceğini belirler
effectiveDate		string (date-time)	Artımlı yenileme ilkesi uygulanırsa, effectiveDate parametresi geçerli tarihi geçersiz kılar.
maxParallelism		integer	Paralel işleme komutlarının çalıştırıldığı en fazla iş parçacığı sayısı
objects		DatasetRefreshObjects[]	İşlenecek nesne dizisi
retryCount		integer	İşlemin başarısız olmadan önce yeniden deneme sayısı. Geçici iç hatalar, bu parametre 0 olarak ayarlandığında bile yenilemenin yeniden denenme işlemini tetikleyebilir.
timeout		string pattern: ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]$	Bir timeout belirtilirse, anlamsal modeldeki her veri yenileme girişimi bu zaman aşımına bağlı kalır. Tek bir yenileme isteğinin, retryCount belirtilirse birden çok deneme içerebileceğini ve bunun toplam yenileme süresinin belirtilen zaman aşımını aşmasına neden olabileceğini unutmayın. Örneğin, 1 saatlik bir timeout ve 2 retryCount ayarlamak, toplam yenileme süresinin 3 saate kadar çıkmasına yol açabilir. Kullanıcılar, daha hızlı hata algılama için yenileme süresini kısaltmak için timeout ayarlayabilir veya daha karmaşık veri yenilemeleri için varsayılan 5 saati aşabilir. Ancak, yeniden denemeler de dahil olmak üzere toplam yenileme süresi 24 saati aşamaz.
type		DatasetRefreshType	Gerçekleştirilecek işleme türü

Yanıtlar

Name	Tür	Description
202 Accepted		Kabul Üst Bilgiler x-ms-request-id: string Location: string

Örnekler

Example of refreshing a dataset

Example of refreshing one partition

Example of refreshing a dataset

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Örnek yanıt

Durum kodu:

202

x-ms-request-id: 03f22bb5-2e98-4ae8-8113-329bec3987b1
Location: https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/03f22bb5-2e98-4ae8-8113-329bec3987b1

Example of refreshing one partition

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

İstek Gövdesi

{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false",
  "timeout": "05:00:00"
}

Örnek yanıt

Durum kodu:

200

Tanımlar

Name	Description
DatasetCommitMode	Nesnelerin toplu olarak mı yoksa yalnızca tamamlandığında mı işleneceğini belirler
DatasetRefreshObjects	Power BI veri kümesi yenileme hedefi
DatasetRefreshRequest	Power BI veri kümesi yenileme isteği
DatasetRefreshType	Gerçekleştirilecek işleme türü
NotifyOption	Posta bildirimi seçenekleri

DatasetCommitMode

Listeleme

Nesnelerin toplu olarak mı yoksa yalnızca tamamlandığında mı işleneceğini belirler

Değer	Description
Transactional	Yenileme işleminin tamamını işlem olarak işleme
PartialBatch	Yenileme işlemini toplu olarak işleyin. partialBatch modu kullanıldığında, yenileme işlemi bir işlem içinde gerçekleşmez. Sonuç olarak, her komut ayrı ayrı işlenir ve bir hata durumunda model verilerin yalnızca bir alt kümesinin yüklendiği veya tablonun boş bırakıldığı bir duruma gelebilir. Bir hata durumunda önceki verilerin korunmasını garanti etmek istiyorsanız, işlemi commitMode = transactional.

DatasetRefreshObjects

Object

Power BI veri kümesi yenileme hedefi

Name	Tür	Description
partition	string	Yenilenecek bölüm
table	string	Yenilenecek tablo

DatasetRefreshRequest

Object

Power BI veri kümesi yenileme isteği

Name	Tür	Description
applyRefreshPolicy	boolean	İlkenin uygulanılıp uygulanmadığını belirleme
commitMode	DatasetCommitMode	Nesnelerin toplu olarak mı yoksa yalnızca tamamlandığında mı işleneceğini belirler
effectiveDate	string (date-time)	Artımlı yenileme ilkesi uygulanırsa, effectiveDate parametresi geçerli tarihi geçersiz kılar.
maxParallelism	integer	Paralel işleme komutlarının çalıştırıldığı en fazla iş parçacığı sayısı
notifyOption	NotifyOption	Posta bildirim seçenekleri. Bu parametre, bir hizmet sorumlusuyla yapılan gelişmiş yenilemeler veya API işlemleri için geçerli değildir.
objects	DatasetRefreshObjects[]	İşlenecek nesne dizisi
retryCount	integer	İşlemin başarısız olmadan önce yeniden deneme sayısı. Geçici iç hatalar, bu parametre 0 olarak ayarlandığında bile yenilemenin yeniden denenme işlemini tetikleyebilir.
timeout	string pattern: ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]$	Bir timeout belirtilirse, anlamsal modeldeki her veri yenileme girişimi bu zaman aşımına bağlı kalır. Tek bir yenileme isteğinin, retryCount belirtilirse birden çok deneme içerebileceğini ve bunun toplam yenileme süresinin belirtilen zaman aşımını aşmasına neden olabileceğini unutmayın. Örneğin, 1 saatlik bir timeout ve 2 retryCount ayarlamak, toplam yenileme süresinin 3 saate kadar çıkmasına yol açabilir. Kullanıcılar, daha hızlı hata algılama için yenileme süresini kısaltmak için timeout ayarlayabilir veya daha karmaşık veri yenilemeleri için varsayılan 5 saati aşabilir. Ancak, yeniden denemeler de dahil olmak üzere toplam yenileme süresi 24 saati aşamaz.
type	DatasetRefreshType	Gerçekleştirilecek işleme türü

DatasetRefreshType

Listeleme

Gerçekleştirilecek işleme türü

Değer	Description
Full	Belirtilen bölüm, tablo veya veritabanındaki tüm bölümler için verileri yenileyin ve tüm bağımlıları yeniden hesap edin. Hesaplama bölümü için bölümü ve tüm bağımlılarını yeniden hesaplayarak.
ClearValues	Bu nesnedeki ve tüm bağımlılarındaki değerleri temizle
Calculate	Bu nesneyi ve tüm bağımlılarını yeniden hesaplayın, ancak yalnızca gerekirse. Bu değer geçici formüller dışında yeniden hesaplamayı zorlamaz.
DataOnly	Bu nesnedeki verileri yenile ve tüm bağımlıları temizle
Automatic	Nesnenin yenilenmesi ve yeniden hesaplanması gerekiyorsa, nesneyi ve tüm bağımlılarını yenileyin ve yeniden hesap edin. Bölüm Hazır dışında bir durumdaysa geçerlidir.
Defragment	Belirtilen tablodaki verileri birleştirin. Tabloya veri eklendikçe veya tablodan kaldırıldığında, her sütunun sözlükleri artık gerçek sütun değerlerinde bulunmayan değerlerle kirletilebilir. Birleştirme seçeneği artık kullanılmayan sözlüklerdeki değerleri temizler.

NotifyOption

Listeleme

Posta bildirimi seçenekleri

Değer	Description
NoNotification	Bildirim gönderilmez
MailOnFailure	Yenileme hatasında bir posta bildirimi gönderilecek
MailOnCompletion	Yenileme tamamlandığında başarılı veya başarısız olduğunu belirten bir posta bildirimi gönderilir