CHANGETABLE (Transact-SQL)

Syntaxe

CHANGETABLE (
        { CHANGES table , last_sync_version
        | VERSION table , <primary_key_values> } )
[AS] table_alias [ ( column_alias [ ,...n ] )

<primary_key_values> ::=
( column_name [ , ...n ] ) , ( value [ , ...n ] )

Arguments

• CHANGES table , last_sync_version
  Retourne les informations de suivi de toutes les modifications apportées à une table depuis la version spécifiée par last_sync_version.

  • table
    Table définie par l'utilisateur sur laquelle obtenir le suivi des modifications. Le suivi des modifications doit être activé sur la table. Un nom de table en une, deux, trois ou quatre parties peut être utilisé. Le nom de table peut être un synonyme de la table.

  • last_sync_version
    Lorsqu'elle obtient des modifications, l'application appelante doit spécifier le point à partir duquel les modifications sont requises. L'argument last_sync_version spécifie ce point. La fonction retourne des informations pour toutes les lignes qui ont été modifiées depuis la version considérée. L'application exécute une requête pour recevoir les modifications avec une version supérieure à last_sync_version.

    Généralement, avant d'obtenir les modifications, l'application appelle CHANGE_TRACKING_CURRENT_VERSION() pour obtenir la version qui sera utilisée la prochaine fois que les modifications seront nécessaires. Par conséquent, l'application n'a pas besoin d'interpréter ou comprendre la valeur réelle.

    Comme last_sync_version est obtenu par l'application appelante, celle-ci doit rendre la valeur persistante. Si l'application perd cette valeur, elle doit alors réinitialiser les données.

    .

    L'argument last_sync_version est de type bigint. La valeur doit être scalaire. Une expression entraîne une erreur de syntaxe.

    Si la valeur est NULL, toutes les modifications suivies sont retournées.

    L'argument last_sync_version doit être validé pour garantir qu'il n'est pas trop ancien, car une partie ou l'ensemble des informations de modification peut avoir été nettoyé selon la période de rétention configurée pour la base de données. Pour plus d'informations, consultez CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL) et Options SET de ALTER DATABASE (Transact-SQL).

• VERSION table, { <primary_key_values> }
  Retourne les informations de suivi des modifications les plus récentes pour une ligne spécifiée. Les valeurs de clé primaire doivent identifier la ligne. <primary_key_values> identifie les colonnes de clé primaire et spécifie les valeurs. Les noms des colonnes de clé primaire peuvent être spécifiés dans n'importe quel ordre.

  • Table
    Table définie par l'utilisateur sur laquelle obtenir les informations de suivi des modifications. Le suivi des modifications doit être activé sur la table. Un nom de table en une, deux, trois ou quatre parties peut être utilisé. Le nom de table peut être un synonyme de la table.

  • column_name
    Spécifie le nom de la colonne ou des colonnes de clé primaire. Plusieurs noms de colonne peuvent être spécifiés dans un ordre quelconque.

  • Value
    Valeur de la clé primaire. S'il existe plusieurs colonnes de clé primaire, les valeurs doivent être spécifiées dans l'ordre dans lequel les colonnes apparaissent dans la liste column_name.

• [AS] table_alias [ (column_alias [ ,...n ] ) ]
  Fournit des noms pour les résultats retournés par CHANGETABLE.

  • table_alias
    Nom d'alias de la table retournée par CHANGETABLE. table_alias est requis et doit être un identificateur valide.

  • column_alias
    Alias de colonne facultatif ou liste d'alias de colonne pour les colonnes retournées par CHANGETABLE. Ce paramètre permet de personnaliser les noms de colonne au cas où il existerait des noms en double dans les résultats.

Types de retour

table

Valeurs de retour

CHANGETABLE CHANGES

Lorsque CHANGES est spécifié, zéro, une ou plusieurs lignes contenant les colonnes suivantes sont retournées.

Nom de la colonne	Type de données	Description
SYS_CHANGE_VERSION	bigint	Valeur de version associée à la dernière modification apportée à la ligne
SYS_CHANGE_CREATION_VERSION	bigint	Valeurs de version associées à la dernière opération d'insertion.
SYS_CHANGE_OPERATION	nchar(1)	Spécifie le type de modification : U = Mettre à jour I = Insérer D = Supprimer
SYS_CHANGE_COLUMNS	varbinary(4100)	Répertorie les colonnes qui ont été modifiées depuis la version de référence. Remarque Les colonnes calculées ne sont jamais répertoriées comme ayant été modifiées. La valeur est NULL si l'une des conditions suivantes est remplie : le suivi des modifications de colonne n'est pas activé ; il s'agit d'une opération d'insertion ou de suppression ; toutes les colonnes dépourvues de clés primaires ont été mises à jour en une seule opération. Cette valeur binaire ne doit pas être interprétée directement. Pour l'interpréter, il convient plutôt d'utiliser CHANGE_TRACKING_IS_COLUMN_IN_MASK ().
SYS_CHANGE_CONTEXT	varbinary(128)	Modifiez les informations de contexte que vous pouvez éventuellement spécifier à l'aide de la clause WITH dans le cadre d'une instruction INSERT, UPDATE ou DELETE.
<valeur de colonne de clé primaire>	Identique aux colonnes de table utilisateur	Valeurs de clés primaires pour la table faisant l'objet d'un suivi. Ces valeurs identifient de manière unique chaque ligne dans la table utilisateur.

CHANGETABLE VERSION

Notes

La fonction CHANGETABLE est utilisée en général dans la clause FROM d'une requête comme s'il s'agissait d'une table.

CHANGETABLE(CHANGES...)

CHANGETABLE(VERSION...)

Autorisations

Requiert les autorisations suivantes sur la table spécifiée par la valeur table pour obtenir les informations de suivi des modifications :

• Autorisation SELECT sur les colonnes de clé primaire

• VIEW CHANGE TRACKING

Exemples

A. Retour de lignes pour une synchronisation initiale des données

-- Get all current rows with associated version
SELECT e.[Emp ID], e.SSN, e.FirstName, e.LastName,
    c.SYS_CHANGE_VERSION, c.SYS_CHANGE_CONTEXT
FROM Employees AS e
CROSS APPLY CHANGETABLE 
    (VERSION Employees, ([Emp ID], SSN), (e.[Emp ID], e.SSN)) AS c;

B. Liste de toutes les modifications apportées depuis une version spécifique

DECLARE @last_sync_version bigint;
SET @last_sync_version = <value obtained from query>;
SELECT [Emp ID], SSN,
    SYS_CHANGE_VERSION, SYS_CHANGE_OPERATION,
    SYS_CHANGE_COLUMNS, SYS_CHANGE_CONTEXT 
FROM CHANGETABLE (CHANGES Employees, @last_sync_version) AS C;

C. Obtention de toutes les données modifiées pour une synchronisation

-- Get all changes (inserts, updates, deletes)
DECLARE @last_sync_version bigint;
SET @last_sync_version = <value obtained from query>;
SELECT e.FirstName, e.LastName, c.[Emp ID], c.SSN,
    c.SYS_CHANGE_VERSION, c.SYS_CHANGE_OPERATION,
    c.SYS_CHANGE_COLUMNS, c.SYS_CHANGE_CONTEXT 
FROM CHANGETABLE (CHANGES Employees, @last_sync_version) AS c
    LEFT OUTER JOIN Employees AS e
        ON e.[Emp ID] = c.[Emp ID] AND e.SSN = c.SSN;

D. Détection des conflits à l'aide de CHANGETABLE (VERSION...)

-- @last_sync_version must be set to a valid value
UPDATE
    SalesLT.Product
SET
    ListPrice = @new_listprice
FROM
    SalesLT.Product AS P
WHERE
    ProductID = @product_id AND
    @last_sync_version >= ISNULL (
        (SELECT CT.SYS_CHANGE_VERSION FROM 
            CHANGETABLE(VERSION SalesLT.Product,
            (ProductID), (P.ProductID)) AS CT),
        0);

Voir aussi

Référence

Concepts