sys.sp_cdc_help_change_data_capture (Transact-SQL)

Si applica a:SQL Server

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 SQL Server. Per un elenco delle funzionalità supportate dalle edizioni di SQL Server, vedere Edizioni e funzionalità supportate di SQL Server 2022.

Convenzioni di 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 in cui appartiene la tabella di origine. @source_schema è sysname, con il valore predefinito NULL. Quando si specifica @source_schema , è necessario specificare anche @source_name .

Se non null, @source_schema deve esistere nel database corrente.

Se @source_schema è diverso da Null, anche @source_name deve essere diverso da null.

[ @source_name = ] 'source_name'

Nome della tabella di origine. @source_name è sysname, con un valore predefinito .NULL Quando si specifica @source_name , è necessario specificare anche @source_schema .

Se non null, @source_name deve esistere nel database corrente.

Se @source_name è diverso da Null, @source_schema deve anche essere diverso da Null.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 basso 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 (11.x), questa colonna è sempre NULL.
supports_net_changes	bit	Il supporto delle modifiche totali è abilitato.
has_drop_pending	bit	Non usato in SQL Server 2012 (11.x).
role_name	sysname	Nome del ruolo del database utilizzato per controllare l'accesso ai dati delle modifiche. NULL = non viene usato 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:

Quando sia @source_schemache @source_name valore predefinito su NULL o vengono impostate in modo esplicito su NULL, questa stored procedure restituisce informazioni per tutte le istanze di acquisizione di database a cui il chiamante ha accesso edizione Standard LECT. Quando @source_schema e @source_name non sono Null, vengono restituite solo informazioni sulla tabella denominata abilitata specifica.

Autorizzazioni

Quando @source_schema e @source_name sono NULL, l'autorizzazione del chiamante determina quali tabelle abilitate sono 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 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

R. Restituire le informazioni di configurazione di Change Data Capture per una tabella specificata

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

USE AdventureWorks2022;
GO

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

B. Restituire le 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 AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_help_change_data_capture;
GO