Condividi tramite


CHANGETABLE (Transact-SQL)

Restituisce informazioni sul rilevamento delle modifiche per una tabella. È possibile utilizzare questa istruzione per restituire tutte le modifiche per una tabella o informazioni sul rilevamento delle modifiche per una riga specifica.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • table CHANGES, last_sync_version
    Restituisce informazioni sul rilevamento per tutte le modifiche a una tabella occorse a partire dalla versione specificata da last_sync_version.

    • table
      Tabella definita dall'utente di cui ottenere le modifiche rilevate. Il rilevamento delle modifiche deve essere attivato nella tabella. È possibile utilizzare un nome di tabella composto da una, due, tre o quattro parti. Il nome della tabella può esserne un sinonimo.

    • last_sync_version
      Quando ottiene modifiche, l'applicazione chiamante deve specificare il punto dal quale sono richieste le modifiche. Tale punto viene specificato da last_sync_version. La funzione restituisce informazioni per tutte le righe modificate a partire dalla versione indicata. L'applicazione esegue una query per ricevere modifiche con una versione successiva a quella restituita da last_sync_version.

      In genere, prima di ottenere le modifiche, l'applicazione chiama CHANGE_TRACKING_CURRENT_VERSION() per ottenere la versione che verrà utilizzata alla successiva richiesta di modifiche. Non è pertanto necessario che l'applicazione interpreti o conosca il valore effettivo.

      Poiché last_sync_version viene ottenuto dall'applicazione chiamante, il relativo valore dovrà essere salvato in modo permanente in tale applicazione. In caso di perdita del valore, sarà necessario reinizializzare i dati.

      .

      last_sync_version è di tipo bigint. Il valore deve essere scalare. Un'espressione provocherà un errore di sintassi.

      Se il valore è NULL, vengono restituite tutte le modifiche rilevate.

      È necessario convalidare last_sync_version per assicurarsi che la versione non sia obsoleta, dato che alcune o tutte le informazioni sulle modifiche potrebbero essere state rimosse in base al periodo di memorizzazione configurato per il database. Per ulteriori informazioni, vedere CHANGE_TRACKING_MIN_VALID_VERSION (Transact-SQL) e Opzioni ALTER DATABASE SET (Transact-SQL).

  • VERSION table, { <primary_key_values> }
    Restituisce le informazioni più recenti sul rilevamento delle modifiche per una riga specificata. I valori della chiave primaria devono identificare la riga. <primary_key_values> identifica le colonne di chiave primaria e specifica i valori. I nomi delle colonne di chiave primaria possono essere specificati in qualsiasi ordine.

    • Table
      Tabella definita dall'utente di cui ottenere le informazioni sul rilevamento delle modifiche. Il rilevamento delle modifiche deve essere attivato per la tabella. È possibile utilizzare un nome di tabella composto da una, due, tre o quattro parti. Il nome della tabella può esserne un sinonimo.

    • column_name
      Specifica il nome della colonna o delle colonne di chiave primaria. È possibile specificare in qualsiasi ordine più nomi di colonna.

    • Value
      Il valore della chiave primaria. In presenza di più colonne di chiave primaria, i valori devono essere specificati nello stesso ordine di visualizzazione delle colonne nell'elenco column_name.

  • [AS] table_alias [ (column_alias [ ,...n ] ) ]
    Fornisce nomi per i risultati restituiti da CHANGETABLE.

    • table_alias
      Il nome alias della tabella restituito da CHANGETABLE. table_alias è obbligatorio e deve essere un identificatore valido.

    • column_alias
      Alias di colonna facoltativo o elenco di alias di colonna per le colonne restituite da CHANGETABLE. Consente la personalizzazione dei nomi di colonna in caso di nomi duplicati nei risultati.

Tipi restituiti

table

Valori restituiti

CHANGETABLE CHANGES

Specificando CHANGES, vengono restituite zero o più righe che presentano le colonne seguenti.

Nome colonna

Tipo di dati

Descrizione

SYS_CHANGE_VERSION

bigint

Valore della versione associato all'ultima modifica alla riga

SYS_CHANGE_CREATION_VERSION

bigint

Valori della versione associati all'ultima operazione di inserimento.

SYS_CHANGE_OPERATION

nchar(1)

Specifica il tipo di modifica:

U = Aggiornamento

I = Inserimento

D = Eliminazione

SYS_CHANGE_COLUMNS

varbinary(4100)

Elenca le colonne modificate a partire dalla versione di riferimento.

NotaNota
Le colonne calcolate non vengono mai elencate come colonne modificate.

Il valore è NULL quando viene soddisfatta una o più delle condizioni seguenti:

  • Il rilevamento delle modifiche per le colonne non è attivato.

  • L'operazione è di inserimento o di eliminazione.

  • Tutte le colonne di chiave non primaria sono state aggiornate in un'unica operazione. Questo valore binario non deve essere interpretato direttamente. Per interpretarlo, utilizzare CHANGE_TRACKING_IS_COLUMN_IN_MASK ().

SYS_CHANGE_CONTEXT

varbinary(128)

Modificare le informazioni di contesto specificabili facoltativamente utilizzando la clausola WITH come parte di un'istruzione INSERT, UPDATE o DELETE.

<<valore della colonna di chiave primaria>>

Come per le colonne della tabella utente

Valori della chiave primaria per la tabella rilevata. Questi valori identificano in modo univoco ogni riga nella tabella utente.

CHANGETABLE VERSION

Quando si specifica VERSION, viene restituita una riga con le colonne seguenti.

Nome colonna

Tipo di dati

Descrizione

SYS_CHANGE_VERSION

bigint

Il valore della versione corrente associato alla riga.

Il valore è NULL se non è stata effettuata alcuna modifica per un periodo superiore a quello di memorizzazione del rilevamento delle modifiche, oppure se la riga non è stata modificata a partire dall'attivazione del rilevamento delle modifiche.

SYS_CHANGE_CONTEXT

varbinary(128)

Modificare le informazioni di contesto specificabili liberamente utilizzando la clausola WITH come parte di un'istruzione INSERT, UPDATE o DELETE.

<<valore della colonna di chiave primaria>>

Come per le colonne della tabella utente

Valori della chiave primaria per la tabella rilevata. Questi valori identificano in modo univoco ogni riga nella tabella utente.

Osservazioni

La funzione CHANGETABLE è in genere utilizzata nella clausola FROM di una query come se si trattasse di una tabella.

CHANGETABLE(CHANGES...)

Per ottenere i dati delle righe per le righe nuove o modificate, unire il set di risultati alla tabella utente utilizzando le colonne di chiave primaria. Viene restituita una sola riga per ogni riga nella tabella utente modificata, anche in presenza di più modifiche alla stessa riga a partire dal valore last_sync_version.

Le modifiche alla colonna di chiave primaria non vengono mai contrassegnate come aggiornamenti. Se il valore della chiave primaria cambia, ciò viene considerato come un'eliminazione del valore obsoleto e un inserimento del nuovo valore.

Se si elimina una riga per poi inserire una riga con la chiave primaria obsoleta, la modifica viene considerata come un aggiornamento per tutte le colonne nella riga.

I valori restituiti per le colonne SYS_CHANGE_OPERATION e SYS_CHANGE_COLUMNS sono relativi alla versione di riferimento specificata. Ad esempio, se un'operazione di inserimento viene effettuata alla versione 10 e un'operazione di aggiornamento alla versione 15, se il riferimento dato da last_sync_version è 12, verrà riportato un aggiornamento. Se invece il valore dato da last_sync_version è 8, verrà riportato un inserimento. I valori SYS_CHANGE_COLUMNS non riporteranno mai colonne calcolate come aggiornate.

Generalmente, vengono rilevate tutte le operazioni che consentono di inserire, aggiornare o eliminare i dati nelle tabelle utente, inclusa l'istruzione MERGE.

Le operazioni seguenti che influiscono sui dati delle tabelle utente non vengono rilevate:

  • Esecuzione dell'istruzione UPDATETEXT.

    Questa istruzione è obsoleta e verrà rimossa in una versione futura di SQL Server. Vengono tuttavia rilevate le modifiche apportate utilizzando la clausola .WRITE dell'istruzione UPDATE.

  • Eliminazione di righe utilizzando TRUNCATE TABLE

    Quando una tabella viene troncata, le informazioni sulla versione del rilevamento delle modifiche associata alla tabella vengono reimpostate, come se il rilevamento delle modifiche fosse stato appena abilitato nella tabella. Un'applicazione client deve sempre convalidare l'ultima versione sincronizzata. La convalida non riesce se la tabella è stata troncata.

CHANGETABLE(VERSION...)

Se viene specificata una chiave primaria inesistente, viene restituito un set di risultati vuoto.

Il valore di SYS_CHANGE_VERSION potrebbe essere NULL se non sono state apportate modifiche per un periodo superiore a quello di memorizzazione, ad esempio se la pulizia ha eliminato le informazioni sulle modifiche, o se la riga non è mai stata modificata dal momento dell'abilitazione del rilevamento delle modifiche per la tabella.

Autorizzazioni

Richiede le autorizzazioni seguenti per la tabella specificata dal valore table al fine di ottenere le informazioni sul rilevamento delle modifiche:

  • Autorizzazione SELECT per le colonne di chiave primaria

  • VIEW CHANGE TRACKING

Esempi

A. Restituzione delle righe per una sincronizzazione iniziale dei dati

Nell'esempio seguente viene illustrato come ottenere i dati per una sincronizzazione iniziale dei dati della tabella. La query restituisce tutti i dati delle righe e le relative versioni associate. Sarà quindi possibile inserire o aggiungere tali dati al sistema che conterrà i dati sincronizzati.

-- 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. Elenco di tutte le modifiche effettuate a partire da una versione specifica

Nell'esempio seguente viene illustrato come elencare tutte le modifiche effettuate in una tabella a partire dalla versione specificata (@last_sync_version). [Emp ID] e SSN sono colonne in una chiave primaria composta.

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. Acquisizione di tutti i dati modificati per una sincronizzazione

Nell'esempio seguente viene illustrato come ottenere tutti i dati modificati. La query unisce le informazioni sul rilevamento delle modifiche alla tabella utente, in modo da restituire le informazioni sulla tabella utente. Utilizzando un LEFT OUTER JOIN viene restituita una riga per le righe eliminate.

-- 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. Rilevamento di conflitti utilizzando CHANGETABLE(VERSION...)

Nell'esempio seguente viene illustrato come aggiornare una riga che non ha subito modifiche dall'ultima sincronizzazione. Il numero di versione della riga specifica si ottiene utilizzando CHANGETABLE. Se la riga è stata aggiornata, le modifiche non vengono effettuate e la query restituisce informazioni sulla sua modifica più recente.

-- @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);