CHANGETABLE (Transact-SQL)

Sintaxis

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

Argumentos

• CHANGES table , last_sync_version
  Devuelve información de seguimiento de todos los cambios en una tabla ocurridos desde la versión especificada por last_sync_version.

  • table
    Es la tabla definida por el usuario de la que obtener cambios a los que se ha realizado el seguimiento. El seguimiento de cambios debe estar habilitado en la tabla. Puede utilizarse un nombre de tabla de uno, dos, tres o cuatro partes. El nombre de tabla puede ser un sinónimo de la tabla.

  • last_sync_version
    Cuando obtiene cambios, la aplicación que realiza la llamada debe especificar el punto del que se requieren cambios. El parámetro last_sync_version especifica ese punto. La función devuelve de todas las filas que se han cambiado desde esa versión. La aplicación consulta la recepción de cambios con una versión superior a last_sync_version.

    Normalmente, antes de obtener cambios, la aplicación llamará a CHANGE_TRACKING_CURRENT_VERSION() para obtener la versión que se utilizará la próxima vez que se requieran cambios. Por consiguiente, la aplicación no tiene que interpretar ni conocer el valor real.

    Dado que el valor de last_sync_version lo obtiene la aplicación que realiza la llamada, la aplicación tiene que conservar el valor. Si la aplicación pierde este valor, será necesario reinicializar los datos.

    .

    last_sync_version es de tipo bigint. El valor debe ser escalar. Una expresión producirá un error de sintaxis.

    Si el valor es NULL, se devuelven todos los cambios a los que se ha realizado el seguimiento.

    Debería validarse last_sync_version para asegurarse de que no es demasiado antigua, porque es posible que se haya limpiado parte o toda la información de cambios, dependiendo del período de retención configurado para la base de datos. Para obtener más información, vea CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL) y Opciones de ALTER DATABASE SET (Transact-SQL).

• VERSION table, { <primary_key_values> }
  Devuelve la última información de seguimiento de cambios para una fila especificada. Los valores de clave principal deben identificar la fila. <primary_key_values> identifica las columnas de clave principal y especifica los valores. Los nombres de columna de clave principal se pueden especificar en cualquier orden.

  • Table
    Es la tabla definida por el usuario de la que obtener la información de seguimiento de cambios. El seguimiento de cambios debe estar habilitado en la tabla. Puede utilizarse un nombre de tabla de uno, dos, tres o cuatro partes. El nombre de tabla puede ser un sinónimo de la tabla.

  • column_name
    Especifica el nombre de la columna o columnas de clave principal. Se pueden especificar varios nombres de columna y en cualquier orden.

  • Value
    Es el valor de la clave principal. Si hay varias columnas de clave principal, los valores deben especificarse en el mismo orden en que aparecen las columnas en la lista column_name.

• [AS] table_alias [ (column_alias [ ,...n ] ) ]
  Proporciona los nombres de los resultados devueltos por CHANGETABLE.

  • table_alias
    Es el nombre de alias de la tabla devuelta por CHANGETABLE. table_alias es necesario y deber ser un identificador válido.

  • column_alias
    Es un alias de columna opcional o lista de alias de columna para las columnas devueltas por CHANGETABLE. Esto permite personalizar los nombres de columna en caso de que haya nombres duplicados en los resultados.

Tipos de valor devueltos

table

Valores devueltos

CHANGETABLE CHANGES

Si se especifica CHANGES, se devuelven cero o varias filas con las columnas siguientes.

Nombre de columna	Tipo de datos	Descripción
SYS_CHANGE_VERSION	bigint	Valor de versión asociado al último cambio de la fila
SYS_CHANGE_CREATION_VERSION	bigint	Valores de versión asociados a la última operación de inserción.
SYS_CHANGE_OPERATION	nchar(1)	Especifica el tipo de cambio: U = Actualización I = Inserción D = Eliminación
SYS_CHANGE_COLUMNS	varbinary(4100)	Enumera las columnas que han cambiado desde la versión básica. Nota Las columnas calculadas nunca se presentan como cambiadas. El valor es NULL si se cumple una cualquiera de las siguientes condiciones: El seguimiento de cambios de columna no está habilitado. Se trata de una operación de eliminación o de inserción. Se actualizaron en una única operación todas las columnas de clave no principal. No debería interpretarse directamente este valor binario. En su lugar, para interpretarlo utilice CHANGE_TRACKING_IS_COLUMN_IN_MASK ().
SYS_CHANGE_CONTEXT	varbinary(128)	Cambie la información de contexto que se puede especificar opcionalmente usando la cláusula WITH como parte de una instrucción INSERT, UPDATE o DELETE.
<<valor de columna de clave principal>>	Igual que las columnas de tabla de usuario	Los valores de clave principal de la tabla con seguimiento. Estos valores identifican de manera única cada fila en la tabla de usuario.

CHANGETABLE VERSION

Notas

Normalmente, la función CHANGETABLE se utiliza en la cláusula FROM de una consulta como si fuera una tabla.

CHANGETABLE(CHANGES...)

CHANGETABLE(VERSION...)

Permisos

Requiere los siguientes permisos en la tabla especificada por el valor table para obtener la información de seguimiento de cambios:

• Permiso SELECT en las columnas de clave principal

• VIEW CHANGE TRACKING

Ejemplos

A. Devolver las filas para una sincronización inicial de los datos

-- 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. Enumerar todos los cambios realizados desde una versión concreta

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. Obtener todos los datos cambiados para una sincronización

-- 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. Detectar conflictos mediante 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);

Vea también

Referencia

Conceptos