CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

Article
07/05/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne la version minimale sur le client valide pour une utilisation dans l’obtention d’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 renvoyé

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, cela supprime toutes les informations de suivi des modifications associées à la table.

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 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 est @last_sync_version inférieure à la valeur de @min_valid_version, la liste des lignes modifiées ne sera pas valide.

Remarque

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)

Partage via