• Artículo

CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

Devuelve la mínima versión válida que se puede usar para obtener la información de seguimiento de cambios desde la tabla especificada cuando se está utilizando la función CHANGETABLE.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

CHANGE_TRACKING_MIN_VALID_VERSION ( table_object_id )

Argumentos

  • table_object_id
    Es el Id. del objeto de una tabla. table_object_id es de tipo int.

Tipo de valor devuelto

bigint

Notas

Utilice esta función para validar el valor del parámetro last_sync_version para CHANGETABLE. Si last_sync_version es menor que el valor comunicado por esta función, es posible que los resultados devueltos por una llamada posterior a CHANGETABLE no sean válidos.

CHANGE_TRACKING_MIN_VALID_VERSION utiliza la información siguiente para determinar el valor devuelto:

  • Si la tabla estaba habilitada para el seguimiento de cambios.

  • Si se ejecutó la tarea de limpieza en segundo plano para quitar la información de seguimiento de cambios más antigua que el período de la retención especificado para la base de datos.

  • Si la tabla estaba truncada. Se quita toda la información del seguimiento de cambios asociada a la tabla.

La función devuelve NULL si se cumple una cualquiera de las siguientes condiciones:

  • El seguimiento de cambios no está habilitado para la base de datos.

  • El Id. del objeto de tabla especificado no es válido para la base de datos actual.

  • Permiso insuficiente para la tabla especificada por el Id. del objeto.

Ejemplos

El ejemplo siguiente determina si la versión especificada es una versión válida. El ejemplo obtiene la versión válida mínima de la tabla dbo.Employees y, a continuación, la compara con el valor de la variable @last\_sync\_version. Si el valor de @last\_sync\_version es menor que el valor de @min\_valid\_version, la lista de filas cambiadas no será válida.

[!NOTA]

Normalmente, se obtendrá el valor de una tabla o de otra ubicación donde se almacenó el último número de versión utilizado para sincronizar los datos.

-- The tracked change is tagged with the specified context 
DECLARE @min_valid_version bigint, @last_sync_version bigint;
SET @min_valid_version = 
CHANGE_TRACKING_MIN_VALID_VERSION(OBJECT_ID('dbo.Employees'));
SET @last_sync_version = 11
IF (@last_sync_version < @min_valid_version)
-- Error � do not obtain changes
ELSE
-- Obtain changes using CHANGETABLE(CHANGES ...)