Condividi tramite


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