sys.sp_cdc_disable_db (Transact-SQL)

適用対象:SQL Server

現在のデータベースの変更データ キャプチャ (CDC) を無効にします。 変更データ キャプチャは、SQL Server のすべてのエディションで使用できるわけではありません。 SQL Server の各エディションでサポートされる機能の一覧については、「SQL Server 2022 の各エディションとサポートされている機能」を参照してください。

Transact-SQL 構文表記規則

構文

sys.sp_cdc_disable_db
[ ; ]

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

ありません。

解説

sys.sp_cdc_disable_db は、現在有効になっているデータベース内のすべてのテーブルの変更データ キャプチャを無効にします。 変更テーブル、ジョブ、ストアド プロシージャ、関数など、変更データ キャプチャに関連するすべてのシステム オブジェクトが削除されます。 is_cdc_enabled sys.databases カタログ ビューのデータベース エントリの列は 、次の値に0設定されます。

変更データ キャプチャが無効になっている時点でデータベースに対して多数のキャプチャ インスタンスが定義されている場合、実行時間の sys.sp_cdc_disable_db 長いトランザクションによって実行が失敗する可能性があります。 この問題は、実行sys.sp_cdc_disable_db前に個々sys.sp_cdc_disable_tableのキャプチャ インスタンスを無効にすることで回避できます。

アクセス許可

Azure SQL Managed Instance または SQL Server での 変更データ キャプチャには、sysadmin 固定サーバー ロールのメンバーシップが必要です。 Azure SQL Database の Change Data Capture のdb_owner のメンバーシップが必要です。

次の例では、AdventureWorks2022 データベースで変更データ キャプチャを無効にします。

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_db;
GO