Share via

Datasets - Refresh Dataset In Group

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

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

Oprávnění

Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

  • U sdílených kapacit je možné iniciovat maximálně osm požadavků za den, včetně aktualizací provedených pomocí plánované aktualizace.
  • V případě sdílených kapacit je možné zadat pouze notifyOption text 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 parametrů, než notifyOption je požadováno.
  • U kapacit Premium je maximální počet požadavků 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/groups/{groupId}/datasets/{datasetId}/refreshes

Parametry identifikátoru URI

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

string

ID datové sady
groupId
 path True

string

uuid

ID pracovního prostoru

Text požadavku

Name Vyžadováno Typ Description
notifyOption True

NotifyOption

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

boolean

Určení, jestli se zásada používá, nebo ne
commitMode

DatasetCommitMode

Určuje, zda 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

Kolikrát se operace bude opakovat, než selže
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/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

Definice

Name Description
DatasetCommitMode

Určuje, zda 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, zda 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 se každý příkaz potvrdí zvlášť a v případě selhání může model skončit ve stavu, kdy se načte 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 provést pomocí příkazu 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ásada používá, nebo ne
commitMode

DatasetCommitMode

Určuje, zda 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 e-mailového oznámení. 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

Kolikrát se operace bude opakovat, než selže
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. Platí, pokud je oddíl v jiném stavu než Připraveno.
Calculate

string

Přepočítat 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

Aktualizovat data v tomto objektu a vymazat všechny závislé objekty
Defragment

string

Defragmentujte data v zadané tabulce. Při přidání dat do tabulky nebo jejich odebrání 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ících, 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

Po dokončení aktualizace se odešle e-mailové oznámení o úspěchu nebo neúspěchu.
MailOnFailure

string

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

string

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