CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Retourne la version minimale sur le client qui est valide pour l’obtention des informations de suivi des modifications à partir de la table spécifiée, lorsque vous utilisez la fonction CHANGETABLE .

Conventions de la syntaxe Transact-SQL

Syntaxe

  
CHANGE_TRACKING_MIN_VALID_VERSION ( table_object_id )  

Arguments

table_object_id
ID d’objet de la table. table_object_id est un int.

Type de retour

bigint

Notes

Utilisez cette fonction pour valider la valeur du paramètre last_sync_version pour CHANGETABLE. Si last_sync_version est inférieur à la valeur signalée par cette fonction, les résultats retournés par un appel ultérieur à CHANGETABLE peuvent ne pas être valides.

CHANGE_TRACKING_MIN_VALID_VERSION utilise les informations suivantes pour déterminer la valeur de retour :

• Lorsque la table a été activée pour le suivi des modifications.

• Lorsque la tâche de nettoyage en arrière-plan s'est exécutée pour supprimer des informations de suivi des modifications antérieures à la période de rétention spécifiée pour la base de données.

• Si la table a été tronquée, toutes les informations de suivi des modifications associées à la table sont supprimées.

La fonction retourne la valeur NULL si l'une des conditions suivantes est remplie :

• Le suivi des modifications n’est pas activé pour la base de données.

• L’ID d’objet de table spécifié n’est pas valide pour la base de données active.

• Autorisation insuffisante pour la table spécifiée par l'ID d'objet.

Exemples

L'exemple suivant détermine si la version spécifiée est valide. L'exemple obtient la version valide minimale de la table dbo.Employees, puis la compare à la valeur de la variable @last_sync_version. Si la valeur de @last_sync_version est inférieure à la valeur de @min_valid_version, la liste des lignes modifiées ne sera pas valide.

Notes

Généralement, vous pouvez obtenir la valeur à partir d'une table ou d'un autre emplacement dans lequel vous avez stocké le dernier numéro de version utilisé pour synchroniser les données.

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

Voir aussi

Fonctions de suivi des modifications (Transact-SQL)
sys.change_tracking_tables (Transact-SQL)