Datasets - Refresh Dataset In Group
Attiva un aggiornamento per il set di dati specificato dall'area di lavoro specificata. Viene attivato un aggiornamento avanzato solo se è impostato un payload di richiesta diverso notifyOption
da .
Autorizzazioni
Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.
Ambito obbligatorio
Dataset.ReadWrite.All
Limitazioni
- Per le capacità condivise, è possibile avviare un massimo di otto richieste al giorno, inclusi gli aggiornamenti eseguiti tramite l'aggiornamento pianificato.
- Per Le capacità condivise, è possibile specificare solo
notifyOption
nel corpo della richiesta. - L'aggiornamento avanzato non è supportato per le capacità condivise.
- Per l'aggiornamento avanzato,
notifyOption
non è obbligatorio e deve essere escluso dal corpo della richiesta. Tuttavia, uno o più parametri diversi danotifyOption
sono obbligatori. - Per le capacità Premium, le richieste massime al giorno sono limitate solo dalle risorse disponibili nella capacità. Se le risorse disponibili sono in overload, gli aggiornamenti vengono limitati fino a quando il carico non viene ridotto. L'aggiornamento avrà esito negativo se la limitazione supera 1 ora.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
dataset
|
path | True |
string |
ID del set di dati |
group
|
path | True |
string uuid |
ID area di lavoro |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
notifyOption | True |
Opzioni di notifica tramite posta elettronica. Questo parametro non è applicabile agli aggiornamenti avanzati o alle operazioni API con un'entità servizio. |
|
applyRefreshPolicy |
boolean |
Determinare se il criterio viene applicato o meno |
|
commitMode |
Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine |
||
effectiveDate |
string |
Se viene applicato un criterio di aggiornamento incrementale, il |
|
maxParallelism |
integer |
Numero massimo di thread in cui eseguire comandi di elaborazione parallela |
|
objects |
Matrice di oggetti da elaborare |
||
retryCount |
integer |
Numero di tentativi prima dell'esito negativo dell'operazione |
|
type |
Tipo di elaborazione da eseguire |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
202 Accepted |
Accettato Headers
|
Esempio
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
Definizioni
Nome | Descrizione |
---|---|
Dataset |
Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine |
Dataset |
Destinazione di aggiornamento del set di dati di Power BI |
Dataset |
Richiesta di aggiornamento del set di dati di Power BI |
Dataset |
Tipo di elaborazione da eseguire |
Notify |
Opzioni di notifica tramite posta elettronica |
DatasetCommitMode
Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine
Nome | Tipo | Descrizione |
---|---|---|
PartialBatch |
string |
Eseguire il commit dell'operazione di aggiornamento in batch. Quando si |
Transactional |
string |
Eseguire il commit dell'intera operazione di aggiornamento come transazione |
DatasetRefreshObjects
Destinazione di aggiornamento del set di dati di Power BI
Nome | Tipo | Descrizione |
---|---|---|
partition |
string |
Partizione da aggiornare |
table |
string |
Tabella da aggiornare |
DatasetRefreshRequest
Richiesta di aggiornamento del set di dati di Power BI
Nome | Tipo | Descrizione |
---|---|---|
applyRefreshPolicy |
boolean |
Determinare se il criterio viene applicato o meno |
commitMode |
Determina se gli oggetti verranno sottoposti a commit in batch o solo al termine |
|
effectiveDate |
string |
Se viene applicato un criterio di aggiornamento incrementale, il |
maxParallelism |
integer |
Numero massimo di thread in cui eseguire comandi di elaborazione parallela |
notifyOption |
Opzioni di notifica tramite posta elettronica. Questo parametro non è applicabile agli aggiornamenti avanzati o alle operazioni API con un'entità servizio. |
|
objects |
Matrice di oggetti da elaborare |
|
retryCount |
integer |
Numero di tentativi prima dell'esito negativo dell'operazione |
type |
Tipo di elaborazione da eseguire |
DatasetRefreshType
Tipo di elaborazione da eseguire
Nome | Tipo | Descrizione |
---|---|---|
Automatic |
string |
Se l'oggetto deve essere aggiornato e ricalcolato, eseguire l'operazione richiesta sia per l'oggetto che per tutti i dipendenti. Si applica se la partizione è in uno stato diverso da pronta. |
Calculate |
string |
Ricalcolare questo oggetto e tutti i relativi dipendenti, ma solo se necessario. Questo valore non forza il ricalcolo, ad eccezione delle formule volatili. |
ClearValues |
string |
Cancellare i valori in questo oggetto e tutti i relativi dipendenti |
DataOnly |
string |
Aggiornare i dati in questo oggetto e cancellare tutti i dipendenti |
Defragment |
string |
Deframmentare i dati nella tabella specificata. Man mano che vengono aggiunti o rimossi dati in una tabella, i dizionari di ogni colonna possono risultare contaminati da valori che non esistono più tra i valori di colonna effettivi. L'opzione defragment consentirà di pulire i valori non più usati nei dizionari. |
Full |
string |
Per tutte le partizioni della partizione, della tabella o del database specificati, aggiornare i dati e ricalcolare tutti i dipendenti. Per una partizione di calcolo, ricalcolare la partizione e tutti i relativi dipendenti. |
NotifyOption
Opzioni di notifica tramite posta elettronica
Nome | Tipo | Descrizione |
---|---|---|
MailOnCompletion |
string |
Una notifica di posta elettronica che indica l'esito positivo o negativo verrà inviato al completamento dell'aggiornamento |
MailOnFailure |
string |
Una notifica di posta elettronica verrà inviata in caso di errore di aggiornamento |
NoNotification |
string |
Non verrà inviata alcuna notifica |