CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Devolve a versão mínima no cliente que é válida para obter informação de rastreio de alterações da tabela especificada, quando está a usar a função CHANGETABLE .

Transact-SQL convenções de sintaxe

Sintaxe

  
CHANGE_TRACKING_MIN_VALID_VERSION ( table_object_id )  

Arguments

table_object_id
É o ID do objeto da tabela. table_object_id é uma inteligência.

Tipo de Retorno

bigint

Observações

Use esta função para validar o valor do parâmetro last_sync_version para CHANGETABLE. Se last_sync_version for inferior ao valor reportado por esta função, os resultados retornados de uma chamada posterior para CHANGETABLE podem não ser válidos.

CHANGE_TRACKING_MIN_VALID_VERSION utiliza a seguinte informação para determinar o valor de retorno:

• Quando a tabela foi ativada para acompanhamento de alterações.

• Quando a tarefa de limpeza em segundo plano foi executada para remover informações de rastreio de alterações mais antigas do que o período de retenção especificado para a base de dados.

• Se a tabela foi truncada, isto remove toda a informação de acompanhamento de alterações associada à tabela.

A função devolve NULL se qualquer uma das seguintes condições for verdadeira:

• O acompanhamento de alterações não está ativado para a base de dados.

• O ID de objeto da tabela especificado não é válido para a base de dados atual.

• Permissão insuficiente para a tabela especificada pelo ID do objeto.

Examples

O exemplo seguinte determina se uma versão especificada é válida. O exemplo obtém a versão mínima válida da dbo.Employees tabela e depois compara-a com o valor da @last_sync_version variável. Se o valor de @last_sync_version for inferior ao valor de @min_valid_version, a lista de linhas alteradas não será válida.

Observação

Normalmente, obtém-se o valor de uma tabela ou outro local onde se guardou o último número de versão usado para sincronizar os dados.

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

Consulte também

Funções de controlo de alterações (Transact-SQL)
sys.change_tracking_tables (Transact-SQL)