sys.sp_cdc_help_change_data_capture (Transact-SQL)

Articolo
08/21/2024

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 varie edizioni di SQL Server, vedere Edizioni e funzionalità supportate di SQL Server 2017.

Convenzioni relative alla 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_schema che @source_name valore predefinito su o vengono impostate in modo esplicito NULL, questa NULLstored procedure restituisce informazioni per tutte le istanze di acquisizione di database a cui il chiamante ha accesso SELECT. 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 le tabelle abilitate 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

Condividi tramite