sys.sp_cdc_enable_db (Transact-SQL)

Aplica-se a: SQL Server

Habilita o Change Data Capture para o banco de dados atual. Esse procedimento deve ser executado para um banco de dados antes que qualquer tabela possa ser habilitada para captura de dados de alteração (CDC) nesse banco de dados. O Change Data Capture registra, insere, atualiza, e exclui atividades aplicadas às tabelas habilitadas, disponibilizando os detalhes das alterações em um formato relacional de fácil de consumir. Informações de coluna que espelham a estrutura de coluna de uma tabela de origem rastreada são capturadas para as linhas modificadas, juntamente com os metadados necessários para aplicar as alterações a um ambiente de destino.

Importante

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_enable_db
[ ; ]

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

A captura de dados de alteração não pode ser habilitada em bancos de dados do sistema ou bancos de dados de distribuição.

sys.sp_cdc_enable_db cria os objetos de captura de dados de alteração que têm escopo em todo o banco de dados, incluindo tabelas de metadados e gatilhos DDL. Ele também cria o esquema CDC e o usuário do banco de dados CDC e define a is_cdc_enabled coluna para a entrada do banco de dados na exibição do catálogo sys.databases como 1.

Permissões

Requer associação na função de servidor fixa sysadmin para o Change Data Capture na Instância Gerenciada de SQL do Azure ou no SQL Server. Requer associação ao db_owner para Captura de Dados de Alteração no Banco de Dados SQL do Azure.

Exemplos

O exemplo a seguir habilita a captura de dados de alterações.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_enable_db;
GO