Condividi tramite

Datasets - Refresh Dataset In Group

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
v1.0

Attiva un aggiornamento per il set di dati specificato dall'area di lavoro specificata. Viene attivato un di aggiornamento avanzato solo se è impostato un payload di richiesta diverso da .

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'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 è necessario e deve essere escluso dal corpo della richiesta. Tuttavia, sono necessari uno o più parametri diversi da notifyOption.
  • 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
datasetId
 path True

string

ID set di dati
groupId
 path True

string

uuid

ID dell'area di lavoro

Corpo della richiesta

Nome Necessario Tipo Descrizione
notifyOption True

NotifyOption

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

DatasetCommitMode

Determina se viene eseguito il commit degli oggetti in batch o solo al termine
effectiveDate

string

Se viene applicato un criterio di aggiornamento incrementale, il parametro effectiveDate sostituisce la data corrente.
maxParallelism

integer

Numero massimo di thread in cui eseguire comandi di elaborazione parallela
objects

DatasetRefreshObjects[]

Matrice di oggetti da elaborare
retryCount

integer

Numero di tentativi prima dell'esito negativo dell'operazione. Gli errori interni temporanei possono attivare un nuovo tentativo di aggiornamento, anche quando questo parametro è impostato su 0.
type

DatasetRefreshType

Tipo di elaborazione da eseguire

Risposte

Nome Tipo Descrizione
202 Accepted

Accettato

Intestazioni

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

Esempio

Example of refreshing a dataset
Example of refreshing one partition

Example of refreshing a dataset

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Corpo della richiesta
{
  "notifyOption": "MailOnFailure",
  "retryCount": 3
}

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Corpo della richiesta
{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false"
}

Risposta di esempio

Codice di stato:
200

Definizioni

Nome Descrizione
DatasetCommitMode

Determina se viene eseguito il commit degli oggetti in batch o solo al termine
DatasetRefreshObjects

Destinazione di aggiornamento del set di dati di Power BI
DatasetRefreshRequest

Richiesta di aggiornamento del set di dati di Power BI
DatasetRefreshType

Tipo di elaborazione da eseguire
NotifyOption

Opzioni di notifica tramite posta elettronica

DatasetCommitMode

Determina se viene eseguito il commit degli oggetti in batch o solo al termine

Nome Tipo Descrizione
PartialBatch

string

Eseguire il commit dell'operazione di aggiornamento in batch. Quando si utilizza la modalità partialBatch, l'operazione di aggiornamento non viene eseguita all'interno di una transazione. Di conseguenza, ogni comando verrà eseguito il commit singolarmente e, in caso di errore, il modello potrebbe terminare in uno stato in cui viene caricato solo un subset dei dati oppure la tabella viene lasciata vuota. Se si desidera garantire la conservazione dei dati precedenti in caso di errore, è necessario eseguire l'operazione con commitMode = transactional.
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

DatasetCommitMode

Determina se viene eseguito il commit degli oggetti in batch o solo al termine
effectiveDate

string

Se viene applicato un criterio di aggiornamento incrementale, il parametro effectiveDate sostituisce la data corrente.
maxParallelism

integer

Numero massimo di thread in cui eseguire comandi di elaborazione parallela
notifyOption

NotifyOption

Opzioni di notifica tramite posta elettronica. Questo parametro non è applicabile agli aggiornamenti avanzati o alle operazioni API con un'entità servizio.
objects

DatasetRefreshObjects[]

Matrice di oggetti da elaborare
retryCount

integer

Numero di tentativi prima dell'esito negativo dell'operazione. Gli errori interni temporanei possono attivare un nuovo tentativo di aggiornamento, anche quando questo parametro è impostato su 0.
type

DatasetRefreshType

Tipo di elaborazione da eseguire

DatasetRefreshType

Tipo di elaborazione da eseguire

Nome Tipo Descrizione
Automatic

string

Se l'oggetto deve essere aggiornato e ricalcolato, aggiornare e ricalcolare l'oggetto e tutte le relative dipendenze. Si applica se la partizione è in uno stato diverso da Pronto.
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 i dati vengono aggiunti o rimossi da una tabella, i dizionari di ogni colonna possono diventare inquinati con valori che non esistono più nei valori effettivi della colonna. L'opzione di deframmentazione pulisce i valori nei dizionari che non vengono più usati.
Full

string

Per tutte le partizioni nella partizione, nella tabella o nel database specificato, aggiornare i dati e ricalcolare tutti i dipendenti. Per una partizione di calcolo, ricalcolare la partizione e tutte le relative dipendenze.

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

Verrà inviata una notifica di posta elettronica in caso di errore di aggiornamento
NoNotification

string

Non verrà inviata alcuna notifica