sys.sp_cdc_disable_table (Transact-SQL)
適用対象: SQL サーバー
指定したソース テーブルの変更データ キャプチャと、現在のデータベース内のキャプチャ インスタンスを無効にします。 変更データ キャプチャは、SQL Server のすべてのエディションで使用できるわけではありません。 SQL Server の各エディションでサポートされる機能の一覧については、「SQL Server 2022 の各エディションとサポートされている機能」を参照してください。
構文
sys.sp_cdc_disable_table
[ @source_schema = ] 'source_schema'
, [ @source_name = ] 'source_name'
[ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]
引数
[ @source_schema = ] 'source_schema'
ソース テーブルが含まれているスキーマの名前。 @source_schema は既定 sysnameであり、 NULL
することはできません。
@source_schema は、現在のデータベースに存在する必要があります。
[ @source_name = ] 'source_name'
変更データ キャプチャを無効にするソース テーブルの名前。 @source_name は既定 sysnameであり、 NULL
することはできません。
@source_name は、現在のデータベースに存在する必要があります。
[ @capture_instance = ] { 'capture_instance' |'all' }
指定したソース テーブルに対して無効にするキャプチャ インスタンスの名前。 @capture_instanceは sysname でありNULL
することはできません。
all
を指定すると、@source_nameに対して定義されているすべてのキャプチャ インスタンスが無効になります。
リターン コードの値
0
(成功) または 1
(失敗)。
結果セット
ありません。
解説
sys.sp_cdc_disable_table
は、指定されたソース テーブルとキャプチャ インスタンスに関連付けられている変更データ キャプチャ変更テーブルとシステム関数を削除します。 変更データ キャプチャ システム テーブルから指定したキャプチャ インスタンスに関連付けられている行をすべて削除し、sys.tables カタログ ビューのテーブル エントリのis_tracked_by_cdc
列を0
に設定します。
アクセス許可
db_owner 固定データベース ロール内でメンバーシップが必要です。
例
次の例では、 HumanResources.Employee
テーブルの変更データ キャプチャを無効にします。
USE AdventureWorks2022;
GO
EXECUTE sys.sp_cdc_disable_table
@source_schema = N'HumanResources',
@source_name = N'Employee',
@capture_instance = N'HumanResources_Employee';