sys.sp_cdc_disable_table (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Deaktiviert Change Data Capture für die angegebene Quelltabelle und die Aufzeichnungsinstanz in der aktuellen Datenbank. Änderungsdatenerfassung ist in jeder Edition von SQL Server nicht verfügbar. Eine Liste der Funktionen, die von den SQL Server-Editionen unterstützt werden, finden Sie unter Editionen und unterstützte Funktionen von SQL Server 2022.

Transact-SQL-Syntaxkonventionen

Syntax

sys.sp_cdc_disable_table
    [ @source_schema = ] 'source_schema'
      , [ @source_name = ] 'source_name'
    [ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]

Argumente

[ @source_schema = ] 'source_schema'

Der Name des Schemas, in dem die Quelltabelle enthalten ist. @source_schema ist "sysname" ohne Standard und kann nicht seinNULL.

@source_schema muss in der aktuellen Datenbank vorhanden sein.

[ @source_name = ] 'source_name'

Der Name der Quelltabelle, aus der die Änderungsdatenerfassung deaktiviert werden soll. @source_name ist "sysname" ohne Standard und kann nicht seinNULL.

@source_name muss in der aktuellen Datenbank vorhanden sein.

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

Der Name der Aufnahmeinstanz, die für die angegebene Quelltabelle deaktiviert werden soll. @capture_instance ist "sysname" und kann nicht seinNULL.

Wenn all angegeben, werden alle für @source_name definierten Aufnahmeinstanzen deaktiviert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

sys.sp_cdc_disable_table legt die Änderungsdatenerfassungsänderungstabelle und Systemfunktionen ab, die der angegebenen Quelltabelle und erfassungsinstanz zugeordnet sind. Es löscht alle Zeilen, die der angegebenen Erfassungsinstanz zugeordnet sind, aus den Änderungsdatenerfassungssystemtabellen und legt die is_tracked_by_cdc Spalte für den Tabelleneintrag in der Katalogansicht sys.tables auf 0.

Berechtigungen

Hierfür ist die Mitgliedschaft in der festen Datenbankrolle db_owner erforderlich.

Beispiele

Im folgenden Beispiel wird Change Data Capture für die HumanResources.Employee-Tabelle deaktiviert.

USE AdventureWorks2022;
GO

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

Zugehöriger Inhalt