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

Ö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

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

Name	Tür	Description
PartialBatch	string	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.
Transactional	string	Yenileme işleminin tamamını işlem olarak işleme

DatasetRefreshObjects

Power BI veri kümesi yenileme hedefi

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

DatasetRefreshRequest

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	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.
type	DatasetRefreshType	Gerçekleştirilecek işleme türü

DatasetRefreshType

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

Name	Tür	Description
Automatic	string	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.
Calculate	string	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.
ClearValues	string	Bu nesnedeki ve tüm bağımlılarındaki değerleri temizle
DataOnly	string	Bu nesnedeki verileri yenile ve tüm bağımlıları temizle
Defragment	string	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.
Full	string	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.

NotifyOption

Posta bildirimi seçenekleri

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