Datasets - Refresh Dataset

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

Attiva un aggiornamento per il set di dati specificato da Area di lavoro personale. Viene attivato un di aggiornamento avanzato solo se è impostato un payload di richiesta diverso da .

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/datasets/{datasetId}/refreshes

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID set di dati

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

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

Risposta di esempio

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

Esempio di richiesta

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

Condividi tramite

Datasets - Refresh Dataset

Ambito obbligatorio

Limitazioni

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Example of refreshing a dataset

Esempio di richiesta

Risposta di esempio

Example of refreshing one partition

Esempio di richiesta

Risposta di esempio

Definizioni

DatasetCommitMode

DatasetRefreshObjects

DatasetRefreshRequest

DatasetRefreshType

NotifyOption

Risorse aggiuntive