CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve la versión mínima del cliente que es válida para su uso en la obtención de información de seguimiento de cambios de la tabla especificada, cuando se usa la función CHANGETABLE .

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
CHANGE_TRACKING_MIN_VALID_VERSION ( table_object_id )

Argumentos

table_object_id
Es el identificador del objeto de una tabla. table_object_id es un valor int.

Tipo de valor devuelto

bigint

Observaciones

Use esta función para validar el valor del parámetro last_sync_version para CHANGETABLE. Si last_sync_version es menor que el valor notificado por esta función, es posible que los resultados devueltos desde 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 se trunca, se quita toda la información de 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 identificador de objeto de tabla especificado no es válido para la base de datos actual.

  • Permiso insuficiente para la tabla especificada por el identificador 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 modificadas 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 ...)

Consulte también

Funciones de seguimiento de cambios (Transact-SQL)
sys.change_tracking_tables (Transact-SQL)