Поделиться через


sys.sp_cdc_disable_table (Transact-SQL)

Область применения: SQL Server

Отключает систему отслеживания измененных данных для указанной исходной таблицы, а также отключает экземпляр отслеживания в текущей базе данных. Запись измененных данных недоступна в каждом выпуске SQL Server. Список функций, поддерживаемых выпусками SQL Server, см. в выпусках и поддерживаемых функциях SQL Server 2022.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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 удаляет таблицу изменений и системные функции записи измененных данных, связанные с указанной исходной таблицей и экземпляром записи. Он удаляет все строки, связанные с указанным экземпляром записи, из системных таблиц отслеживания измененных данных и задает is_tracked_by_cdc столбец для записи таблицы в представлении 0каталога sys.table.

Разрешения

Требуется членство в предопределенной роли базы данных 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';