CHANGETABLE (Transact-SQL)

Sintaxe

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
  Retorna informações de rastreamento para todas as alterações efetuadas em uma tabela desde a versão especificada por last_sync_version.

  • table
    É a tabela definida pelo usuário na qual as alterações controladas são obtidas. O controle de alterações deve ser ativado na tabela. Um nome de tabela de uma, duas, três ou quatro partes pode ser usado. O nome da tabela pode ser um sinônimo para a tabela.

  • last_sync_version
    Quando obtém alterações, o aplicativo chamador deve especificar o ponto a partir do qual são necessárias alterações. last_sync_version especifica esse ponto. A função retorna informações de todas as linhas que foram alteradas desde essa versão. O aplicativo faz uma consulta para receber alterações com uma versão maior que last_sync_version.

    Normalmente, antes de obter as alterações, o aplicativo chama CHANGE_TRACKING_CURRENT_VERSION() para obter a versão que será utilizada na próxima vez que for necessário fazer alterações. Por isso, o aplicativo não precisa interpretar ou entender o valor real.

    Como last_sync_version é obtido pelo aplicativo chamador, o aplicativo tem que manter o valor. Se o aplicativo perder este valor, ele deverá reinicializar os dados.

    .

    last_sync_version é bigint. O valor deve ser escalar. Uma expressão causará um erro de sintaxe.

    Se o valor for NULL, todas as alterações efetuadas serão retornadas.

    last_sync_version deve ser validado para que não fique muito defasado, visto que algumas ou todas as informações de alteração podem ter sido apagadas de acordo com o período de retenção configurado para o banco de dados. Para obter mais informações, consulte CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL) e Opções ALTER DATABASE SET (Transact-SQL).

• VERSION table, { <primary_key_values> }
  Retorna as informações de controle de alterações mais recentes de uma linha especificada. Valores de chave primários devem identificar a linha. <primary_key_values> identifica as colunas de chave primária e especifica os valores. Os nomes de coluna de chave primária podem ser especificados em qualquer ordem.

  • Table
    É a tabela definida pelo usuário na qual devem ser obtidas as informações de controle de alterações. O controle de alterações deve ser ativado na tabela. Um nome de tabela de uma, duas, três ou quatro partes pode ser usado. O nome da tabela pode ser um sinônimo para a tabela.

  • column_name
    Especifica o nome de coluna/colunas de chave primária. Podem ser especificados vários nomes de coluna em qualquer ordem.

  • Value
    É o valor da chave primária. Se houver várias colunas de chaves primárias, os valores deverão ser especificados na mesma ordem em que as colunas aparecem na lista column_name.

• [AS] table_alias [ (column_alias [ ,...n ] ) ]
  Fornece nomes para os resultados que são retornados por CHANGETABLE.

  • table_alias
    É o nome do alias da tabela retornada por CHANGETABLE. table_alias é obrigatório e deve ser um identificador válido.

  • column_alias
    É um alias de coluna opcional ou lista de aliases de coluna opcional para as colunas que são retornadas por CHANGETABLE. Isso permite que os nomes de colunas sejam personalizados caso haja nomes duplicados nos resultados.

Tipos de retorno

table

Valores de retorno

CHANGETABLE CHANGES

Quando CHANGES é especificado, são retornadas zero ou mais linhas que têm as seguintes colunas.

Nome da coluna	Tipo de dados	Descrição
SYS_CHANGE_VERSION	bigint	Valor de versão associado à última alteração efetuada na linha
SYS_CHANGE_CREATION_VERSION	bigint	Valores de versão associados à última operação de inserção.
SYS_CHANGE_OPERATION	nchar(1)	Especifica o tipo de alteração: U = Atualizar I = Inserir D = Excluir
SYS_CHANGE_COLUMNS	varbinary(4100)	Lista as colunas alteradas desde a versão básica. Observação Colunas computadas nunca são listadas como alteradas. O valor será NULL quando qualquer uma das condições a seguir for verdadeira: O controle de alterações da coluna não está habilitado. A operação é de inserção ou exclusão. Todas as colunas de chave não primária foram atualizadas em uma operação. Este valor binário não deve ser interpretado diretamente. Em vez disso, para interpretá-lo, use CHANGE_TRACKING_IS_COLUMN_IN_MASK ().
SYS_CHANGE_CONTEXT	varbinary(128)	Altere as informações de contexto que podem ser especificadas opcionalmente usando a cláusula WITH como parte de uma instrução INSERT, UPDATE ou DELETE.
<valor de coluna de chave primária>	Igual às colunas de tabela de usuário	Os valores de chave primária da tabela controlada. Esses valores identificam exclusivamente cada linha da tabela do usuário.

CHANGETABLE VERSION

Comentários

Em geral, a função CHANGETABLE é usada na cláusula FROM de uma consulta como se fosse uma tabela.

CHANGETABLE(CHANGES...)

CHANGETABLE(VERSION...)

Permissões

Requer as seguintes permissões na tabela especificada pelo valor table para obter informações de controle de alterações:

• Permissão SELECT nas colunas de chave primária

• VIEW CHANGE TRACKING

Exemplos

A. Retornando linhas para uma sincronização inicial de dados

-- 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. Listando todas as alterações efetuadas desde uma versão específica

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. Obtendo todos os dados alterados de uma sincronização

-- 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. Detectando conflitos usando 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);

Consulte também

Referência

Conceitos