sys.sp_cdc_disable_table (Transact-SQL)

Aplica-se a: SQL Server

Desativa a captura de dados de alterações para a tabela de origem especificada e a captura da instância na base de dados atual. A captura de dados de alterações não está disponível em todas as edições do SQL Server. Para obter uma lista de funcionalidades suportadas pelas edições do SQL Server, consulte Edições e funcionalidades suportadas do SQL Server 2022.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_cdc_disable_table
    [ @source_schema = ] N'source_schema'
    , [ @source_name = ] N'source_name'
    , [ @capture_instance = ] { 'capture_instance' | 'all' }
[ ; ]

Arguments

[ @source_schema = ] N'source_schema'

O nome do esquema em que a tabela fonte está contida. @source_schema é sysname, sem padrão, e não pode ser NULL.

@source_schema deve existir na base de dados atual.

[ @source_name = ] N'source_name'

O nome da tabela de origem a partir da qual a captura de dados de alterações deve ser desativado. @source_name é sysname, sem padrão, e não pode ser NULL.

@source_name deve existir na base de dados atual.

[ @capture_instance = ] { N'capture_instance' | 'todos' }

O nome da instância de captura a desativar para a tabela de origem especificada. @capture_instance é sysname e não pode ser NULL.

Quando all é especificado, todas as instâncias de captura definidas para @source_name são desativadas.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Remarks

sys.sp_cdc_disable_table elimina a tabela de captura de dados de alteração e as funções do sistema associadas à tabela de origem e à instância de captura especificadas. Elimina quaisquer linhas associadas à instância de captura especificada das tabelas do sistema de captura de dados alterados e define a is_tracked_by_cdc coluna para a entrada da tabela na vista de catálogo sys.tables como 0.

Permissions

Requer associação à função fixa de base de dados db_owner.

Examples

O exemplo seguinte desativa a captura de dados de alterações para a HumanResources.Employee tabela.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_table
    @source_schema = N'HumanResources',
    @source_name = N'Employee',
    @capture_instance = N'HumanResources_Employee';

Conteúdo relacionado

• sys.sp_cdc_enable_table (Transact-SQL)