Datasets - Refresh Dataset In Group

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen çalışma alanından belirtilen veri kümesi için yenilemeyi tetikler. İyileştirilmiş yenileme yalnızca dışında notifyOption bir istek yükü ayarlandığında tetiklenir.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

• 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 yalnızca notifyOption istek gövdesinde belirtilebilir.
• Paylaşılan kapasiteler için gelişmiş yenileme desteklenmez.
• Gelişmiş yenileme notifyOption için gerekli değildir ve istek gövdesinden dışlanmalıdır. Ancak, dışında notifyOption 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ük 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/groups/{groupId}/datasets/{datasetId}/refreshes

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği
groupId	path	True	string uuid	Çalışma alanı 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 parametre 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ı
type		DatasetRefreshType	Gerçekleştirilecek işleme türü

Yanıtlar

Name	Tür	Description
202 Accepted		Kabul edildi Headers x-ms-request-id: string Location: string

Örnekler

Example of refreshing a dataset

Example of refreshing one partition

Example of refreshing a dataset

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Request Body

{
  "notifyOption": "MailOnFailure",
  "retryCount": 3
}

Sample Response

Status code:

202

x-ms-request-id: 87f31ef7-1e3a-4006-9b0b-191693e79e9e
Location: https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/87f31ef7-1e3a-4006-9b0b-191693e79e9e

Example of refreshing one partition

Sample Request

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

Request Body

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

Sample Response

Status code:

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 bildirim 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. Modu kullanırken partialBatch 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, 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	Yenilenen bölüm
table	string	Yenilenen 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 parametre 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ı
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	Yalnızca gerekirse, bu nesneyi ve tüm bağımlılarını yeniden hesaplayın. 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ığından, her sütunun sözlükleri artık gerçek sütun değerlerinde bulunmayan değerlerle kirlenebilir. 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 hesap edin.

NotifyOption

Posta bildirim 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önderilecek
MailOnFailure	string	Yenileme hatasında bir posta bildirimi gönderilecek
NoNotification	string	Bildirim gönderilmeyecek