cdc.fn_cdc_get_net_changes_<capture_instance> (Transact-SQL)

Sintassi

cdc.fn_cdc_get_net_changes_capture_instance ( from_lsn , to_lsn , '<row_filter_option>' )

<row_filter_option> ::=
{ all
 | all with mask
 | all with merge
}

Argomenti

• from_lsn
  Il numero LSN che rappresenta l'endpoint inferiore dell'intervallo LSN da includere nel set di risultati. from_lsn è binary(10).

  Solo le righe della tabella delle modifiche cdc.[istanza_acquisizione]_CT con un valore in __$start_lsn maggiore o uguale a from_lsn sono incluse nel set di risultati.

• to_lsn
  Il numero LSN che rappresenta l'endpoint superiore dell'intervallo LSN da includere nel set di risultati. to_lsn è binary(10).

  Solo le righe della tabella delle modifiche cdc.[istanza_acquisizione]_CT con un valore in __$start_lsn minore o uguale a from_lsn o uguale a to_lsn sono incluse nel set di risultati.

• <row_filter_option>:: = { all | all with mask | all with merge}
  Opzione applicata al contenuto delle colonne dei metadati e alle righe restituite nel set di risultati. Le opzioni possibili sono le seguenti:

  • all
    Restituisce il valore LSN della modifica finale alla riga e l'operazione necessaria ad applicare la riga nelle colonne metadati __$start_lsn e __$operation. La colonna __$update_mask è sempre NULL.

  • all with mask
    Restituisce il valore LSN della modifica finale alla riga e l'operazione necessaria ad applicare la riga nelle colonne metadati __$start_lsn e __$operation. Inoltre, quando un'operazione di aggiornamento restituisce (__$operation = 4) le colonne acquisite modificate nell'aggiornamento sono contrassegnate nel valore restituito in __$update_mask.

  • all with merge
    Restituisce il numero LSN della modifica finale alla riga nelle colonne metadati __$start_lsn. __$operation della colonna sarà uno dei due valori: 1 per eliminare e 5 per indicare che l'operazione necessaria ad applicare la modifica è un inserimento o un aggiornamento. La colonna __$update_mask è sempre NULL.

    La logica necessaria a determinare l'operazione precisa per una determinata modifica aggiunge maggiore complessità alla query, pertanto questa opzione è progettata per migliorare le prestazioni di esecuzione delle query quando è sufficiente indicare che l'operazione necessaria ad applicare i dati di modifica è un inserimento o un aggiornamento, ma non è necessario distinguere in modo esplicito tra i due. Questa opzione è molto interessante negli ambienti di destinazione dove è direttamente disponibile un'operazione di unione, ad esempio un ambiente SQL Server 2008.

Tabella restituita

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o al ruolo predefinito del database db_owner. Per tutti gli altri utenti, è richiesta l'autorizzazione SELECT su tutte le colonne acquisite nella tabella di origine e, se è stato definito un ruolo di controllo per l'istanza di acquisizione, l'appartenenza a tale ruolo del database. Se il chiamante non dispone delle autorizzazioni per visualizzare i dati di origine, la funzione restituisce un errore 208 (Il nome di oggetto non è valido).

Osservazioni

Se l'intervallo LSN specificato è esterno alla cronologia di rilevamento delle modifiche per l'istanza di acquisizione, la funzione restituisce un errore 208, in cui è indicato che il nome di oggetto non è valido.

Esempi

Nell'esempio seguente viene utilizzata la funzione cdc.fn_cdc_get_net_changes_HR_Department per segnalare tutte le modifiche apportate alla tabella di origine HumanResources.Department durante un intervallo di tempo specifico.

Innanzitutto, per contrassegnare l'inizio dell'intervallo di tempo viene utilizzata la funzione GETDATE. Dopo l'applicazione delle istruzioni DML alla tabella di origine, la funzione GETDATE viene chiamata nuovamente per identificare la fine dell'intervallo di tempo. Viene quindi utilizzata la funzione sys.fn_cdc_map_time_to_lsn per eseguire il mapping dell'intervallo di tempo a un intervallo di query di acquisizione di dati limitato da valori LSN. Infine, la funzione cdc.fn_cdc_get_net_changes_HR_Department viene eseguita per ottenere tutte le modifiche alla tabella di origine per l'intervallo di tempo. La riga inserita ed eliminata non viene visualizzata nel set dei risultati restituito dalla funzione. Ciò avviene perché una riga aggiunta ed eliminata all'interno di una finestra di query non produce modifiche totali sulla tabella di origine per l'intervallo. Prima di eseguire questo esempio, è innanzitutto necessario eseguire l'esempio B in sys.sp_cdc_enable_table (Transact-SQL).

USE AdventureWorks;
GO
DECLARE @begin_time datetime, @end_time datetime, @from_lsn binary(10), @to_lsn binary(10);
-- Obtain the beginning of the time interval.
SET @begin_time = GETDATE() -1;
-- DML statements to produce changes in the HumanResources.Department table.
INSERT INTO HumanResources.Department (Name, GroupName)
VALUES (N'MyDept', N'MyNewGroup');

UPDATE HumanResources.Department
SET GroupName = N'Resource Control'
WHERE GroupName = N'Inventory Management';

DELETE FROM HumanResources.Department
WHERE Name = N'MyDept';

-- Obtain the end of the time interval.
SET @end_time = GETDATE();
-- Map the time interval to a change data capture query range.
SET @from_lsn = sys.fn_cdc_map_time_to_lsn('smallest greater than or equal', @begin_time);
SET @to_lsn = sys.fn_cdc_map_time_to_lsn('largest less than or equal', @end_time);

-- Return the net changes occurring within the query window.
SELECT * FROM cdc.fn_cdc_get_net_changes_HR_Department(@from_lsn, @to_lsn, 'all');

Vedere anche

Riferimento

Altre risorse