Datasets - Refresh Dataset In Group
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 |
---|---|---|---|---|
dataset
|
path | True |
string |
ID datové sady |
group
|
path | True |
string uuid |
ID pracovního prostoru |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
notifyOption | True |
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 |
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, |
|
maxParallelism |
integer |
Maximální počet vláken, na kterých se mají spouštět příkazy paralelního zpracování |
|
objects |
Pole objektů, které se mají zpracovat |
||
retryCount |
integer |
Kolikrát se operace bude opakovat, než selže |
|
type |
Typ zpracování, který se má provést |
Odpovědi
Name | Typ | Description |
---|---|---|
202 Accepted |
Přijato Headers
|
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
{
"notifyOption": "MailOnFailure",
"retryCount": 3
}
Sample Response
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
{
"type": "full",
"commitMode": "transactional",
"objects": [
{
"table": "Customer",
"partition": "Robert"
}
],
"applyRefreshPolicy": "false"
}
Sample Response
Definice
Name | Description |
---|---|
Dataset |
Určuje, zda budou objekty potvrzeny v dávkách, nebo pouze po dokončení. |
Dataset |
Cíl aktualizace datové sady Power BI |
Dataset |
Žádost o aktualizaci datové sady Power BI |
Dataset |
Typ zpracování, který se má provést |
Notify |
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í |
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 |
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, |
maxParallelism |
integer |
Maximální počet vláken, na kterých se mají spouštět příkazy paralelního zpracování |
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 |
Pole objektů, které se mají zpracovat |
|
retryCount |
integer |
Kolikrát se operace bude opakovat, než selže |
type |
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. |