sys.sp_cdc_disable_db (Transact-SQL)

Gilt für:SQL Server

Deaktiviert die Änderung der Datenerfassung (CDC) für die aktuelle 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_db
[ ; ]

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

sys.sp_cdc_disable_db deaktiviert die Änderungsdatenerfassung für alle Tabellen in der aktuell aktivierten Datenbank. Alle Systemobjekte, die sich auf Change Data Capture beziehen, z. B. Änderungstabellen, Aufträge, gespeicherte Prozeduren und Funktionen, werden gelöscht. Die is_cdc_enabled Spalte für den Datenbankeintrag in der Katalogansicht "sys.databases " ist auf " 0.

Wenn viele Erfassungsinstanzen für die Datenbank zum Zeitpunkt der Änderung der Datenerfassung definiert sind, kann eine lange ausgeführte Transaktion dazu führen, dass die Ausführung sys.sp_cdc_disable_db fehlschlägt. Dieses Problem kann vermieden werden, indem die einzelnen Aufnahmeinstanzen sys.sp_cdc_disable_table vor der Ausführung sys.sp_cdc_disable_dbdeaktiviert werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle "sysadmin" für die Änderungsdatenerfassung in Azure SQL verwaltete Instanz oder SQL Server. Erfordert die Mitgliedschaft im db_owner für die Änderungsdatenerfassung für Azure SQL-Datenbank.

Beispiele

Im folgenden Beispiel wird Change Data Capture für die Datenbank AdventureWorks2022 deaktiviert.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_db;
GO