sys.sp_cdc_disable_table (Transact-SQL)

Aplica-se a: SQL Server

Desabilita a captura de dados de alteração para a tabela de origem especificada e a instância de captura no banco de dados atual. A captura de dados de alteração não está disponível em todas as edições do SQL Server. Para obter uma lista de recursos com suporte nas edições do SQL Server, confira Edições e recursos com suporte no SQL Server 2022.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@source_schema [ = ] 'source_schema'

O nome do esquema no qual a tabela de origem está contida. @source_schema é sysname, sem padrão, e não pode ser NULL.

@source_schema deve existir no banco de dados atual.

@source_name [ = ] 'source_name'

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

@source_name deve existir no banco de dados atual.

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

O nome da instância de captura a ser desabilitada 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 desabilitadas.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sys.sp_cdc_disable_table Descarta a tabela de alterações de captura de dados de alteração e as funções do sistema associadas à tabela de origem especificada e à instância de captura. Ele exclui todas as linhas associadas à instância de captura especificada das tabelas do sistema de captura de dados de alteração e define a is_tracked_by_cdc coluna da entrada da tabela na exibição do catálogo sys.tables como 0.

Permissões

Requer associação na função de banco de dados fixa db_owner.

Exemplos

O exemplo a seguir desabilita a captura de dados de alteração na tabela HumanResources.Employee.

USE AdventureWorks2022;
GO

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