Share via

Datasets - Refresh Dataset

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Aktivuje aktualizaci pro zadanou datovou sadu z mého pracovního prostoru. Rozšířená aktualizace se aktivuje pouze v případě, že je nastavena jiná datová část požadavku, než notifyOption je nastavená.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

  • U sdílených kapacit je možné zahájit maximálně osm požadavků za den, včetně aktualizací spouštěných pomocí plánované aktualizace.
  • Pro sdílené kapacity je možné zadat pouze notifyOption v textu požadavku.
  • U sdílených kapacit se rozšířená aktualizace nepodporuje.
  • Pro rozšířenou aktualizaci notifyOption se nevyžaduje a musí být vyloučena z textu požadavku. Vyžaduje se však jeden nebo více jiných notifyOption parametrů.
  • U kapacit Premium je maximální počet žádostí za den omezený pouze dostupnými prostředky v kapacitě. Pokud jsou dostupné prostředky přetížené, aktualizace se omezují, dokud se zatížení nesníší. Pokud omezení překročí 1 hodinu, aktualizace se nezdaří. 

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
 path True

string

ID datové sady

Text požadavku

Name Vyžadováno Typ Description
notifyOption True

NotifyOption

Možnosti oznámení pošty. Tento parametr se nevztahuje na rozšířené aktualizace ani operace rozhraní API s instančním objektem.
applyRefreshPolicy

boolean

Určení, jestli se zásady používají, nebo ne
commitMode

DatasetCommitMode

Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.
effectiveDate

string

Pokud se použije zásada přírůstkové aktualizace, effectiveDate parametr přepíše aktuální datum.
maxParallelism

integer

Maximální počet vláken, na kterých se mají spouštět příkazy paralelního zpracování
objects

DatasetRefreshObjects[]

Pole objektů, které se mají zpracovat
retryCount

integer

Počet opakování operace před selháním
type

DatasetRefreshType

Typ zpracování, který se má provést

Odpovědi

Name Typ Description
202 Accepted

Přijato

Headers

  • x-ms-request-id: string
  • Location: string

Příklady

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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Sample Response

Status code:
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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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

Definice

Name Description
DatasetCommitMode

Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.
DatasetRefreshObjects

Cíl aktualizace datové sady Power BI
DatasetRefreshRequest

Žádost o aktualizaci datové sady Power BI
DatasetRefreshType

Typ zpracování, který se má provést
NotifyOption

Možnosti oznámení pošty

DatasetCommitMode

Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.

Name Typ Description
PartialBatch

string

Potvrďte operaci aktualizace v dávkách. Při použití partialBatch režimu se operace aktualizace neprovádí v rámci transakce. V důsledku toho bude každý příkaz potvrzen jednotlivě a v případě selhání může model skončit ve stavu, kdy je načtena pouze podmnožina dat nebo tabulka zůstane prázdná. Pokud chcete zaručit zachování předchozích dat v případě selhání, měli byste operaci spustit pomocí commitMode = transactional.
Transactional

string

Potvrzení celé operace aktualizace jako transakce

DatasetRefreshObjects

Cíl aktualizace datové sady Power BI

Name Typ Description
partition

string

Oddíl, který se má aktualizovat
table

string

Tabulka, která se má aktualizovat

DatasetRefreshRequest

Žádost o aktualizaci datové sady Power BI

Name Typ Description
applyRefreshPolicy

boolean

Určení, jestli se zásady používají, nebo ne
commitMode

DatasetCommitMode

Určuje, jestli budou objekty potvrzeny v dávkách nebo pouze po dokončení.
effectiveDate

string

Pokud se použije zásada přírůstkové aktualizace, effectiveDate parametr přepíše aktuální datum.
maxParallelism

integer

Maximální počet vláken, na kterých se mají spouštět příkazy paralelního zpracování
notifyOption

NotifyOption

Možnosti oznámení pošty. Tento parametr se nevztahuje na rozšířené aktualizace ani operace rozhraní API s instančním objektem.
objects

DatasetRefreshObjects[]

Pole objektů, které se mají zpracovat
retryCount

integer

Počet opakování operace před selháním
type

DatasetRefreshType

Typ zpracování, který se má provést

DatasetRefreshType

Typ zpracování, který se má provést

Name Typ Description
Automatic

string

Pokud je potřeba objekt aktualizovat a přepočítat, aktualizujte a přepočítáte objekt a všechny jeho závislé objekty. Použije se v případě, že je oddíl v jiném stavu než Připraveno.
Calculate

string

Přepočítáte tento objekt a všechny jeho závislé objekty, ale pouze v případě potřeby. Tato hodnota nevynucuje přepočet, s výjimkou nestálých vzorců.
ClearValues

string

Vymazat hodnoty v tomto objektu a všech jeho závislých
DataOnly

string

Aktualizujte data v tomto objektu a vymažte všechny závislé objekty.
Defragment

string

Defragmentujte data v zadané tabulce. Při přidání nebo odebrání dat do tabulky se slovníky jednotlivých sloupců můžou znečišťovat hodnotami, které už ve skutečných hodnotách sloupců neexistují. Možnost defragmentace vyčistí hodnoty ve slovníkech, které se už nepoužívají.
Full

string

Pro všechny oddíly v zadaném oddílu, tabulce nebo databázi aktualizujte data a přepočítáte všechny závislé. V případě oddílu výpočtu přepočítáte oddíl a všechny jeho závislé oddíly.

NotifyOption

Možnosti oznámení pošty

Name Typ Description
MailOnCompletion

string

Při dokončení aktualizace se odešle e-mailové oznámení o úspěchu nebo selhání.
MailOnFailure

string

Při selhání aktualizace se odešle e-mailové oznámení.
NoNotification

string

Žádné oznámení se nepošlou.