Condividi tramite


sys.sp_cdc_disable_table (Transact-SQL)

Si applica a: SQL Server

Disabilita Change Data Capture per la tabella di origine e l'istanza di acquisizione specificate nel database corrente. 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_disable_table
    [ @source_schema = ] 'source_schema'
      , [ @source_name = ] 'source_name'
    [ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]

Argomenti

[ @source_schema = ] 'source_schema'

Nome dello schema in cui è contenuta la tabella di origine. @source_schema è sysname, senza impostazione predefinita e non può essere NULL.

@source_schema deve esistere nel database corrente.

[ @source_name = ] 'source_name'

Nome della tabella di origine da cui deve essere disabilitato Change Data Capture. @source_name è sysname, senza impostazione predefinita e non può essere NULL.

@source_name deve esistere nel database corrente.

[ @capture_instance = ] { 'capture_instance' | 'all' }

Nome dell'istanza di acquisizione da disabilitare per la tabella di origine specificata. @capture_instance è sysname e non può essere NULL.

Quando all viene specificato, tutte le istanze di acquisizione definite per @source_name vengono disabilitate.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

sys.sp_cdc_disable_table elimina la tabella delle modifiche di Change Data Capture e le funzioni di sistema associate alla tabella di origine e all'istanza di acquisizione specificate. Elimina tutte le righe associate all'istanza di acquisizione specificata dalle tabelle di sistema di Change Data Capture e imposta la colonna per la is_tracked_by_cdc voce di tabella nella vista del catalogo sys.tables su 0.

Autorizzazioni

Richiede l'adesione al ruolo predefinito del database db_owner.

Esempi

Nell'esempio seguente viene disabilitata l'acquisizione dei dati delle modifiche per la tabella HumanResources.Employee.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_table
    @source_schema = N'HumanResources',
    @source_name = N'Employee',
    @capture_instance = N'HumanResources_Employee';