CHANGETABLE (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. Nota 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

Osservazioni

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

CHANGETABLE(CHANGES...)

CHANGETABLE(VERSION...)

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

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

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

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

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

Vedere anche

Riferimento

Concetti