Datasets - Refresh Dataset
Desencadena una actualización para el conjunto de datos especificado desde Mi área de trabajo. Una actualización mejorada solo se desencadena si se establece una carga de solicitud distinta notifyOption
de la establecida.
Ámbito requerido
Dataset.ReadWrite.All
Limitaciones
- En el caso de las capacidades compartidas, se puede iniciar un máximo de ocho solicitudes al día, incluidas las actualizaciones ejecutadas mediante la actualización programada.
- En el caso de las capacidades compartidas, solo
notifyOption
se puede especificar en el cuerpo de la solicitud. - No se admite la actualización mejorada para las capacidades compartidas.
- Para la actualización mejorada,
notifyOption
no es necesario y debe excluirse del cuerpo de la solicitud. Sin embargo, se requieren uno o varios parámetros distintosnotifyOption
de los necesarios. - En el caso de las capacidades Premium, las solicitudes máximas por día solo están limitadas por los recursos disponibles en la capacidad. Si se sobrecargan los recursos disponibles, las actualizaciones se limitan hasta que se reduce la carga. Se producirá un error en la actualización si la limitación supera las 1 hora.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
Identificador del conjunto de datos |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
notifyOption | True |
Opciones de notificación de correo electrónico. Este parámetro no es aplicable a las actualizaciones mejoradas ni a las operaciones de API con una entidad de servicio. |
|
applyRefreshPolicy |
boolean |
Determinar si la directiva se aplica o no |
|
commitMode |
Determina si los objetos se confirmarán en lotes o solo cuando se completen |
||
effectiveDate |
string |
Si se aplica una directiva de actualización incremental, el parámetro |
|
maxParallelism |
integer |
Número máximo de subprocesos en los que ejecutar comandos de procesamiento paralelo |
|
objects |
Matriz de objetos que se van a procesar |
||
retryCount |
integer |
Número de veces que la operación se reintentará antes de que se produzca un error |
|
type |
Tipo de procesamiento que se va a realizar |
Respuestas
Nombre | Tipo | Description |
---|---|---|
202 Accepted |
Aceptado Headers
|
Ejemplos
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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Sample Response
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
Sample Request
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
{
"type": "full",
"commitMode": "transactional",
"objects": [
{
"table": "Customer",
"partition": "Robert"
}
],
"applyRefreshPolicy": "false"
}
Sample Response
Definiciones
Nombre | Description |
---|---|
Dataset |
Determina si los objetos se confirmarán en lotes o solo cuando se completen |
Dataset |
Destino de actualización del conjunto de datos de Power BI |
Dataset |
Solicitud de actualización del conjunto de datos de Power BI |
Dataset |
Tipo de procesamiento que se va a realizar |
Notify |
Opciones de notificación de correo |
DatasetCommitMode
Determina si los objetos se confirmarán en lotes o solo cuando se completen
Nombre | Tipo | Description |
---|---|---|
PartialBatch |
string |
Confirme la operación de actualización en lotes. Al usar el |
Transactional |
string |
Confirmar toda la operación de actualización como una transacción |
DatasetRefreshObjects
Destino de actualización del conjunto de datos de Power BI
Nombre | Tipo | Description |
---|---|---|
partition |
string |
Partición para actualizar |
table |
string |
Tabla que se va a actualizar |
DatasetRefreshRequest
Solicitud de actualización del conjunto de datos de Power BI
Nombre | Tipo | Description |
---|---|---|
applyRefreshPolicy |
boolean |
Determinar si la directiva se aplica o no |
commitMode |
Determina si los objetos se confirmarán en lotes o solo cuando se completen |
|
effectiveDate |
string |
Si se aplica una directiva de actualización incremental, el parámetro |
maxParallelism |
integer |
Número máximo de subprocesos en los que ejecutar comandos de procesamiento paralelo |
notifyOption |
Opciones de notificación de correo electrónico. Este parámetro no es aplicable a las actualizaciones mejoradas ni a las operaciones de API con una entidad de servicio. |
|
objects |
Matriz de objetos que se van a procesar |
|
retryCount |
integer |
Número de veces que la operación se reintentará antes de que se produzca un error |
type |
Tipo de procesamiento que se va a realizar |
DatasetRefreshType
Tipo de procesamiento que se va a realizar
Nombre | Tipo | Description |
---|---|---|
Automatic |
string |
Si el objeto se debe actualizar, actualice el objeto y todos sus elementos dependientes. Se aplica si la partición se encuentra en un estado que no sea Ready. |
Calculate |
string |
Actualice este objeto y todos sus elementos dependientes, pero solo si es necesario. Este valor no fuerza la actualización, excepto las fórmulas volátiles. |
ClearValues |
string |
Borrar valores en este objeto y todos sus dependientes |
DataOnly |
string |
Actualizar los datos de este objeto y borrar todos los dependientes |
Defragment |
string |
Desfragmente los datos de la tabla especificada. Ya que los datos se agregan a una tabla o se quitan de ella, los diccionarios de cada columna pueden contaminarse con valores que ya no existen en los valores de columna reales. La opción de desfragmentar limpiará los valores de los diccionarios que ya no se usan. |
Full |
string |
Para todas las particiones en la partición, tabla o base de datos especificada, actualice los datos y actualice todos los elementos dependientes. Para una partición de cálculo, actualice la partición y todos sus elementos dependientes. |
NotifyOption
Opciones de notificación de correo
Nombre | Tipo | Description |
---|---|---|
MailOnCompletion |
string |
Se enviará una notificación de correo electrónico que indica que se ha realizado correctamente o se producirá un error al finalizar la actualización. |
MailOnFailure |
string |
Se enviará una notificación por correo cuando se produzca un error de actualización. |
NoNotification |
string |
No se enviará ninguna notificación |