Compartilhar via


sys.sp_cdc_get_captured_columns (Transact-SQL)

Aplica-se: SQL Server

Retorna informações de metadados de captura de dados de alteração das colunas de origem capturadas, localizadas pela instância de captura especificada. 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_get_captured_columns
    [ @capture_instance = ] 'capture_instance'
[ ; ]

Argumentos

@capture_instance [ = ] 'capture_instance'

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

Para relatar as instâncias de captura da tabela, execute o procedimento armazenado sys.sp_cdc_help_change_data_capture .

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
source_schema sysname Nome do esquema de tabela de origem.
source_table sysname Nome da tabela de origem.
capture_instance sysname Nome da instância de captura.
column_name sysname Nome da coluna de origem capturada.
column_id int ID da coluna na tabela de origem.
column_ordinal int Posição da coluna na tabela de origem.
data_type sysname Tipo de dados da coluna.
character_maximum_length int Comprimento máximo de caracteres da coluna baseada em caracteres; caso contrário, NULL.
numeric_precision tinyint Precisão da coluna se baseada em números; caso contrário, NULL.
numeric_precision_radix smallint Base de precisão da coluna se baseada em números; caso contrário, NULL.
numeric_scale int Escala da coluna, se baseada em números; caso contrário, NULL.
datetime_precision smallint Precisão da coluna se baseada em data e hora; caso contrário, NULL.

Comentários

Use sys.sp_cdc_get_captured_columns para obter informações de coluna sobre as colunas capturadas retornadas consultando as funções de consulta da instância de captura cdc.fn_cdc_get_all_changes_<capture_instance> ou cdc.fn_cdc_get_net_changes_<capture_instance>. Os nomes de coluna, ID e posição permanecem constantes durante a duração da instância de captura. Somente o tipo de dados de coluna é alterado quando o tipo de dados da coluna de origem subjacente na tabela controlada é alterado. As colunas adicionadas ou descartadas de uma tabela de origem não têm efeito sobre as colunas capturadas de instâncias de captura existentes.

Use sys.sp_cdc_get_ddl_history para obter informações sobre instruções DDL (linguagem de definição de dados) aplicadas a uma tabela de origem. Qualquer mudança de DDL que modificou a estrutura de uma coluna de origem localizada é retornada no conjunto de resultados.

Permissões

Requer associação na função de banco de dados fixa db_owner. Para todos os outros usuários, requer a permissão SELECT em todas as colunas capturadas na tabela de origem e, se uma função associada para a instância de captura tiver sido definida, faça associação nessa função de banco de dados. Quando o chamador não tem permissão para exibir os dados de origem, a função retorna o Erro 22981 (Object doesn't exist or access is denied.).

Exemplos

O exemplo a seguir retorna informações sobre as colunas capturadas na instância de captura HumanResources_Employee.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_get_captured_columns
    @capture_instance = N'HumanResources_Employee';
GO