¿Qué es una política de actualización?

2023-01-09
Kurt Buhler

Applies to:

✔ Tabular Editor 2
Tabular Editor 3
✔ Desktop

✔ Business

✔ Enterprise

Resumen Visual de la actualización incremental

Los Datasets alojados en el servicio de Power BI pueden configurar la actualización incremental en una o varias tablas de datos. El objetivo de la actualización incremental es lograr actualizaciones más rápidas y eficientes al recuperar solo los datos recientes o cambiantes y actualizar la tabla de forma incremental. Para ello, la tabla se divide automáticamente en particiones, de modo que solo se actualizan los datos recientes o cambiantes (particiones "hot") o incluso se recuperan en tiempo real (particiones "DirectQuery" en "tablas híbridas"), mientras que los datos más antiguos y estáticos se archivan (particiones "cold").

La actualización incremental se puede configurar y modificar fácilmente desde Tabular Editor.

Note

Configurar la actualización incremental puede aportar ventajas a tu Data model:

Reduce el tiempo de actualización y el consumo de recursos
Disfruta de actualizaciones programadas más cortas y fiables

Important

La configuración de la actualización incremental con Tabular Editor 3 se limita a Datasets alojados en el servicio de Datasets de Power BI. Para Analysis Services, se requiere un particionamiento personalizado.

¿Cómo funciona?

Para crear las particiones, Power BI usa los parámetros datetime RangeStart y RangeEnd en Power Query. Estos parámetros se usan en un paso de filtrado de la expresión M de la partición de la tabla, filtrando una columna de fecha y hora de la tabla. Las columnas de tipo fecha, cadena o entero pueden seguir filtrándose manteniendo el plegado de consultas, query folding, mediante funciones que convierten RangeStart, RangeEnd o la columna de fecha al tipo de datos adecuado. Para más información sobre esto, consulta aquí

A continuación se muestra un ejemplo. La actualización incremental se aplica a la tabla 'Orders' en la columna [Order Date]:

// Idealmente, el paso de filtro debería poder plegarse de nuevo al Data source
// Ningún paso anterior a este debería interrumpir el plegado de consultas
#"Incremental Refresh Filter Step" = 
    Table.SelectRows(
        Navigation,
        each 
            [OrderDate] >= #"RangeStart" and 
            [OrderDate] < #"RangeEnd"
    )

let
    // Idealmente, el Data source debería admitir el plegado de consultas
    Source = Sql.Database(#"ServerParameter", #"DatabaseParameter"),

    Navigation = 
        Source{ 
            [ Schema="DW_fact", Item="Internet Sales" ] 
        } [Data],

    // Idealmente, el paso de filtro debería poder plegarse de nuevo al Data source
    // Ningún paso anterior a este debería interrumpir el plegado de consultas
    #"Incremental Refresh Filter Step" = 
        Table.SelectRows(
            Navigation,
            each 
                [OrderDate] >= #"RangeStart" and 
                [OrderDate] < #"RangeEnd"
        )
in
    #"Incremental Refresh Filter Step"

// No importa cuál sea el valor inicial del parámetro RangeStart
// El parámetro debe ser del tipo de datos "datetime"
#datetime(2022, 12, 01, 0, 0, 0) 
    meta 
        [
            IsParameterQuery = true, 
            IsParameterQueryRequired = true, 
            Type = type datetime
        ]

// No importa cuál sea el valor inicial del parámetro RangeEnd
// El parámetro debe ser del tipo de datos "datetime"
#datetime(2022, 12, 31, 0, 0, 0) 
    meta 
        [
            IsParameterQuery = true, 
            IsParameterQueryRequired = true, 
            Type = type datetime
        ]

Warning

La actualización incremental está diseñada para Data source que admiten el plegado de consultas de Power Query. Lo ideal es que el plegado de consultas no se rompa antes de aplicar el paso de filtro. No existe un requisito explícito de que la consulta final se pliegue, excepto al implementar tablas híbridas.

¿Qué es una política de actualización?

Una política de actualización determina cómo se particionan los datos y cuáles de estas particiones del rango de la política se actualizarán al realizar una actualización. Consta de un conjunto de propiedades TOM de la tabla que se pueden configurar o cambiar.

Warning

Limitaciones de Power BI Desktop: No se admite configurar la actualización incremental cuando se está conectado a un modelo local de Power BI Desktop. Para configurar la actualización incremental en un modelo local de Power BI Desktop, utiliza la interfaz de usuario de Power BI Desktop.

Propiedades de la política de actualización

Una política de actualización básica se compone de cuatro tipos distintos de propiedades:

Ventana incremental propiedades: El período durante el cual los datos se mantienen actualizados.
Ventana deslizante propiedades: El período durante el cual los datos se archivan.
Expresiones de origen: Definen el esquema de la tabla y las transformaciones de Power Query de la tabla.
Modo: Si se usan tablas Import o Hybrid.

Ventanas de la política de actualización de la actualización incremental

Comparación con Power BI Desktop

En Power BI Desktop, estas propiedades se denominan de forma diferente. A continuación se muestra una descripción general de cómo se corresponden las propiedades con la interfaz de usuario de Power BI Desktop.

Propiedades de las ventanas de la política de actualización incremental

Propiedades avanzadas

Según las propiedades configuradas, la actualización incremental puede funcionar de forma diferente. A continuación se muestra una descripción general de las distintas configuraciones de actualización incremental:

En la configuración estándar de actualización incremental, todas las particiones se importan en memoria. Las particiones de la ventana móvil se archivan, mientras que las de la ventana incremental se actualizan.

En esta configuración, el intervalo de la política no incluirá el período actual en la ventana móvil.

En la configuración estándar de actualización incremental, el período actual siempre está en la ventana incremental. Puede que este comportamiento no sea el deseado, ya que los datos cambiarán con cada actualización. Si los usuarios no esperan ver datos parciales de un día incompleto, puede configurar "Actualizar solo períodos completos".

Esto se configura con la propiedad IncrementalPeriodsOffset. En el ejemplo anterior, un valor de -1 para un IncrementalGranularity de Day excluirá la fecha actual de la ventana incremental y, por tanto, del ámbito de datos; solo se actualizarán los días completos.

Ventanas de política de actualización incremental

En esta configuración, no se actualizan todos los registros en la ventana incremental. En su lugar, los registros solo se actualizan si cambian. Detectar cambios en los datos puede optimizar aún más el rendimiento de actualización al usar la actualización incremental. Para identificar cambios en los datos, usa una Polling Expression. Una Polling Expression es una propiedad independiente que espera una expresión M válida para identificar la fecha máxima de una lista de fechas.

Normalmente, se usa una Polling Expression en una columna de tipo DateTime de una tabla para identificar la fecha más reciente. Si hay registros que coinciden con esa fecha, se actualizarán. Un ejemplo típico es usar una columna como [LastUpdateDt] para marcar los registros que se actualizaron o se agregaron con el valor DateTime actual. Se actualizan los registros cuyos valores sean iguales al [LastUpdateDt] más reciente.

Note

Los registros en particiones archivadas no se actualizan.

A continuación se muestra un ejemplo de una propiedad Polling Expression válida. Puedes usarlo como plantilla al configurar Detect Data Changes en tu modelo desde Tabular Editor:

// Retrieves the maximum value of the column [LastUpdateDt]
let
    #"maxDateOfLastUpdate" =
        List.max(
            Orders[LastUpdateDt]
        ),

    accountForNu11 =
        if #"maxDateOfLastUpdate" = null
        then #datetime(1901, 01, 01, 00, 00, 00)
        else #"maxDateOfLastUpdate"
in
    accountForNu11

Ventanas de la política de actualización incremental

Resumen de todas las propiedades

A continuación se muestra un resumen de las propiedades de TOM de un Data model que se usan para configurar la actualización incremental:

Nombre de la propiedad	Equivalente en Power BI Desktop	Descripción	Valor esperado
EnableRefreshPolicy	Actualizar esta tabla de forma incremental	Indica si la tabla tiene habilitada una política de actualización. En Tabular Editor, el resto de las propiedades de la política de actualización solo se mostrarán si este valor se establece en `True`.	`True` o `False`.
IncrementalGranularity	Período de actualización incremental	La granularidad de la ventana incremental. Ejemplo: "Actualizar los datos de los últimos 30 días* anteriores a la fecha de actualización."*	`Day`, `Month`, `Quarter` o `Year`. Debe ser menor o igual que el IncrementalGranularity.
IncrementalPeriods	Número de períodos de actualización incremental	El número de períodos de la ventana incremental. Ejemplo: "Actualizar los datos de los últimos 30 días antes de la fecha de actualización."	Un número entero que indique el número de períodos de IncrementalGranularity. Debe definir un período total inferior a RollingWindowPeriods
*IncrementalPeriodsOffset*	Actualizar solo días completos	El desplazamiento que se aplicará a IncrementalPeriods. Ejemplo para: IncrementalPeriodsOffset=`-1`; IncrementalPeriods = `30`; IncrementalGranularity = `Day`: "Actualizar solo los datos de los últimos 30 días, desde el día anterior a la fecha de actualización.	Un número entero con el número de períodos de IncrementalGranularity para desplazar la ventana incremental.
*Modo*	Obtenga los datos más recientes en tiempo real con DirectQuery	Especifica si la actualización incremental se configura únicamente con particiones de importación o también con una partición de DirectQuery, para dar como resultado una "tabla híbrida".	`Import` o `Hybrid`.
*PolicyType*	N/A	Especifica el tipo de política de actualización.	Solo puede contener un único valor: `Basic`.
*PollingExpression* (Opcional)	Detectar cambios en los datos	La expresión M que se usa para detectar cambios en una columna específica, como LastUpdateDate En Tabular Editor, la PollingExpression se puede ver y modificar desde la ventana del Editor de expresiones seleccionándola en el menú desplegable de la esquina superior izquierda.

Nombre de la propiedad	Equivalente en Power BI Desktop	Descripción	Valor esperado
EnableRefreshPolicy	Actualizar esta tabla de forma incremental	Indica si hay una política de actualización habilitada para la tabla. En Tabular Editor, otras propiedades de la política de actualización solo serán visibles si este valor se establece en `True`.	`True` o `False`.
IncrementalGranularity	Período de actualización incremental	La granularidad de la ventana incremental. Ejemplo: "Actualice los datos de los últimos 30 días* antes de la fecha de actualización."*	`Day`, `Month`, `Quarter` o `Year`. Debe ser menor o igual que el valor de IncrementalGranularity.
IncrementalPeriods	Número de períodos de actualización incremental	El número de períodos de la ventana incremental. Ejemplo: "Actualice los datos de los últimos 30 días antes de la fecha de actualización."	Un número entero que indica la cantidad de períodos de IncrementalGranularity. Debe definir un período total inferior a RollingWindowPeriods
*IncrementalPeriodsOffset*	Actualizar solo los días completos	El desplazamiento que se aplicará a IncrementalPeriods. Ejemplo para: IncrementalPeriodsOffset=`-1`; IncrementalPeriods = `30`; IncrementalGranularity = `Day`: "Actualizar solo los datos de los últimos 30 días, desde el día anterior a la fecha de actualización.	Un número entero que indica la cantidad de períodos de IncrementalGranularity para desplazar la ventana incremental.
*Mode*	Obtener los datos más recientes en tiempo real con DirectQuery	Especifica si la actualización incremental está configurada solo con particiones de importación o también con una partición de DirectQuery, para crear una "tabla híbrida".	`Import` o `Hybrid`.
*PolicyType*	N/A	Especifica el tipo de política de actualización.	Solo puede contener un único valor: `Basic`.
*PollingExpression* (Opcional)	Detectar cambios en los datos	La expresión M utilizada para detectar cambios en una columna específica, como LastUpdateDate. En Tabular Editor, la Polling Expression se puede ver y modificar desde la ventana del Editor de expresiones seleccionándola en el menú desplegable de la esquina superior izquierda.	Una expresión M válida que devuelve un valor escalar de la fecha más reciente de una columna. Se actualizarán todos los registros de las particiones activas de la ventana incremental que contengan ese valor en la columna. Los registros de las particiones archivadas no se actualizan.
*RollingWindowGranularity*	Período de archivado de datos	La granularidad de la ventana deslizante. Ejemplo: "Archivar datos a partir de 3 años* antes de la fecha de actualización."*	`Day`, `Month`, `Quarter` o `Year`. Debe ser mayor o igual que IncrementalGranularity.
*RollingWindowPeriods*	Número de períodos de datos archivados	El número de períodos para la ventana móvil. Ejemplo: "Archivar datos a partir de 3 años antes de la fecha de actualización."	Un entero con el número de períodos de RollingWindowGranularity. Debe definir un período total mayor que el IncrementalPeriods
*SourceExpression*	Expresión de origen de Power Query	La expresión M para el Data source de la tabla. Aquí es donde se encuentra la expresión M original de la tabla y donde se modificarían las transformaciones existentes de Power Query. En Tabular Editor, la Source Expression se puede ver y modificar desde el Editor de expresiones seleccionándola en el menú desplegable de la parte superior izquierda.	Una expresión M válida que contenga un paso de filtro usando adecuadamente `RangeStart` y `RangeEnd`.

Table of Contents

¿Qué es una política de actualización?

Note

Important

¿Cómo funciona?

Warning

¿Qué es una política de actualización?

Warning

Propiedades de la política de actualización

Comparación con Power BI Desktop

Propiedades avanzadas

Resumen de todas las propiedades