| title | sys.sp_cdc_disable_db (Transact-SQL) | Microsoft Docs | ||||
|---|---|---|---|---|---|
| ms.custom | |||||
| ms.date | 03/15/2017 | ||||
| ms.prod | sql | ||||
| ms.prod_service | database-engine | ||||
| ms.reviewer | |||||
| ms.technology | system-objects | ||||
| ms.topic | language-reference | ||||
| f1_keywords |
|
||||
| dev_langs |
|
||||
| helpviewer_keywords |
|
||||
| ms.assetid | 420fb99e-e60f-445b-b568-da96471f1e8f | ||||
| author | rothja | ||||
| ms.author | jroth |
[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]
Disables change data capture for the current database. Change data capture is not available in every edition of [!INCLUDEmsCoName][!INCLUDEssNoVersion]. For a list of features that are supported by the editions of [!INCLUDEssNoVersion], see Features Supported by the Editions of SQL Server 2016.
Applies to: [!INCLUDEssNoVersion] ( [!INCLUDEssKatmai] through current version).
Transact-SQL Syntax Conventions
sys.sp_cdc_disable_db 0 (success) or 1 (failure)
None
sys.sp_cdc_disable_db disables change data capture for all tables in the database currently enabled. All system objects related to change data capture, such as change tables, jobs, stored procedures and functions, are dropped. The is_cdc_enabled column for the database entry in the sys.databases catalog view is set to 0.
Note
If there are many capture instances defined for the database at the time change data capture is disabled, a long running transaction can cause the execution of sys.sp_cdc_disable_db to fail. This problem can be avoided by disabling the individual capture instances by using sys.sp_cdc_disable_table before running sys.sp_cdc_disable_db.
Requires membership in the sysadmin fixed server role.
The following example disables change data capture for the AdventureWorks2012 database.
USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_disable_db;
GO sys.sp_cdc_enable_db (Transact-SQL)
sys.sp_cdc_disable_table (Transact-SQL)