CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

ESTE TEMA SE APLICA A:síSQL Server (a partir de 2008)síAzure SQL DatabasenoAzure SQL Data Warehouse noAlmacenamiento de datos paralelos THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Devuelve la versión mínima en el cliente que es válido para usarlo en la obtención de seguimiento de cambios de la tabla especificada, cuando usa el CHANGETABLE función.Returns the minimum version on the client that is valid for use in obtaining change tracking information from the specified table, when you are using the CHANGETABLE function.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax


CHANGE_TRACKING_MIN_VALID_VERSION ( table_object_id )  

ArgumentosArguments

table_object_idtable_object_id
Es el identificador del objeto de una tabla.Is the object ID of the table. table_object_id es un int.table_object_id is an int.

Tipo devueltoReturn Type

bigintbigint

NotasRemarks

Use esta función para validar el valor de la last_sync_version parámetro para CHANGETABLE.Use this function to validate the value of the last_sync_version parameter for CHANGETABLE. Si last_sync_version es menor que el valor notificado por esta función, los resultados devueltos por una llamada posterior a CHANGETABLE podrían no ser válidos.If last_sync_version is less than the value that is reported by this function, the results that are returned from a later call to CHANGETABLE might not be valid.

CHANGE_TRACKING_MIN_VALID_VERSION utiliza la información siguiente para determinar el valor devuelto:CHANGE_TRACKING_MIN_VALID_VERSION uses the following information to determine the return value:

  • Si la tabla estaba habilitada para el seguimiento de cambios.When the table was enabled for change tracking.

  • 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.When the background cleanup task ran to remove change tracking information older than the retention period specified for the database.

  • Si la tabla estaba truncada.If the table was truncated. Se quita toda la información del seguimiento de cambios asociada a la tabla.This removes all change tracking information that is associated with the table.

    La función devuelve NULL si se cumple una cualquiera de las siguientes condiciones:The function returns NULL if any one of the following conditions is true:

  • El seguimiento de cambios no está habilitado para la base de datos.Change tracking is not enabled for the database.

  • El identificador del objeto de tabla especificado no es válido para la base de datos actual.The specified table object ID is not valid for the current database.

  • Permiso insuficiente para la tabla especificada por el identificador del objeto.Insufficient permission to the table specified by the object ID.

EjemplosExamples

El ejemplo siguiente determina si la versión especificada es una versión válida.The following example determines whether a specified version is a valid version. 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.The example obtains the minimum valid version of the dbo.Employees table, and then compares this to the value of the @last_sync_version variable. 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.If the value of @last_sync_version is lower than the value of @min_valid_version, the list of changed rows will not be valid.

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.You would usually obtain the value from a table or other location where you stored the last version number that was used to synchronize data.

-- 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 ...)  

Vea tambiénSee Also

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