sys.sp_cdc_help_change_data_capture (Transact-SQL)

Restituisce la configurazione dell'acquisizione dei dati delle modifiche per ogni tabella abilitata per la modifica dell'acquisizione di dati nel database corrente. Possono essere restituite fino a due righe per ogni tabella di origine, una riga per ogni istanza di acquisizione. Change Data Capture non è disponibile in ogni edizione di Microsoft SQL Server. Per un elenco delle funzionalità supportate dalle edizioni di SQL Server, vedere Funzionalità supportate dalle edizioni di SQL Server 2012.

Convenzioni della sintassi Transact-SQL

Sintassi

sys.sp_cdc_help_change_data_capture 
  [ [ @source_schema = ] 'source_schema' ]
  [, [ @source_name = ] 'source_name' ]

Argomenti

• [ @source\_schema = ] 'source_schema'
  Nome dello schema a cui appartiene la tabella di origine. source_schema è di tipo sysname e il valore predefinito è NULL. Se si specifica source_schema, è necessario specificare anche source_name.

  Se è non NULL, source_schema deve esistere nel database corrente.

  Se source_schema è non NULL, anche source_name deve essere non NULL.

• [ @source\_name = ] 'source_name'
  Nome della tabella di origine. source_name è di tipo sysname e il valore predefinito è NULL. Se si specifica source_name, è necessario specificare anche source_schema.

  Se è non NULL, source_name deve esistere nel database corrente.

  Se source_name è non NULL, anche source_schema deve essere non NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nome colonna	Tipo di dati	Descrizione
source_schema	sysname	Nome dello schema della tabella di origine.
source_table	sysname	Nome della tabella di origine.
capture_instance	sysname	Nome dell'istanza di acquisizione.
object_id	int	ID della tabella delle modifiche associata alla tabella di origine.
source_object_id	int	ID della tabella di origine.
start_lsn	binary(10)	Numero di sequenza del file di log (LSN) che rappresenta l'endpoint inferiore per l'esecuzione di query sulla tabella delle modifiche. NULL = l'endpoint inferiore non è stato stabilito.
end_lsn	binary(10)	Il numero LSN rappresenta l'endpoint superiore per l'esecuzione di query sulla tabella delle modifiche. In SQL Server 2012 questa colonna è sempre NULL.
supports_net_changes	bit	Il supporto delle modifiche totali è abilitato.
has_drop_pending	bit	Non utilizzato in SQL Server 2012.
role_name	sysname	Nome del ruolo del database utilizzato per controllare l'accesso ai dati delle modifiche. NULL = non è utilizzato un ruolo.
index_name	sysname	Nome dell'indice utilizzato per identificare in modo univoco le righe nella tabella di origine.
filegroup_name	sysname	Nome del database filegroup contenente la tabella delle modifiche specificata. NULL = la tabella delle modifiche si trova nel filegroup predefinito del database.
create_date	datetime	Data in cui l'istanza di acquisizione è stata abilitata.
index_column_list	nvarchar(max)	Elenco delle colonne dell'indice utilizzato per identificare in modo univoco le righe nella tabella di origine.
captured_column_list	nvarchar(max)	Elenco delle colonne di origine acquisite.

Osservazioni

Se source_schema e source_name utilizzano NULL come valore predefinito o vengono impostati in modo esplicito su NULL, questa stored procedure restituisce informazioni per tutte le istanze di acquisizione del database di cui il chiamante dispone dell'autorizzazione SELECT per l'accesso. Se source_schema e source_name sono non Null, vengono restituite solo le informazioni sulla tabella abilitata denominata specifica.

Autorizzazioni

Se source_schema e source_name sono NULL, l'autorizzazione del chiamante determina le tabelle abilitate che vengono incluse nel set di risultati. I chiamanti devono disporre dell'autorizzazione SELECT in tutte le colonne acquisite dell'istanza di acquisizione nonché dell'appartenenza a qualsiasi ruolo di controllo definito per le informazioni di tabella da includere. I membri del ruolo del database db_owner possono visualizzare le informazioni su tutte le istanze di acquisizione definite. Se vengono richieste informazioni per una tabella abilitata specifica, alla tabella denominata vengono applicati gli stessi criteri SELECT e di appartenenza.

Esempi

A.Restituzione delle informazioni di configurazione di Change Data Capture per una tabella specifica

L'esempio seguente restituisce la configurazione dell'acquisizione dei dati delle modifiche per la tabella HumanResources.Employee.

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_help_change_data_capture 
    @source_schema = N'HumanResources', 
    @source_name = N'Employee';
GO

B.Restituzione delle informazioni di configurazione di Change Data Capture per tutte le tabelle

Nell'esempio seguente vengono restituite le informazioni di configurazione per tutte le tabelle abilitate nel database contenenti dati delle modifiche a cui il chiamante è autorizzato ad accedere.

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO