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_enabledsys.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 データベースの変更データ キャプチャのdb_ownerのメンバーシップが必要です。

例

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

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_db;
GO

関連項目