Captura de dados de alterações – sys.dm_cdc_log_scan_sessions

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna uma linha para cada sessão de verificação de log no banco de dados atual. A última linha retornada representa a sessão atual. Você pode usar esta exibição para retornar informações de status sobre a sessão de exame de log atual ou informações agregadas sobre todas as sessões desde que a instância do SQL Server foi iniciada pela última vez.

Os registros em sys.dm_cdc_log_scan_sessions são redefinidos sempre que a instância de SQL Server é reiniciada ou após ocorrer um failover. Além disso, se o banco de dados consultado estiver na função secundária de um grupo de disponibilidade Always On, nenhum registro será retornado.

Para obter mais informações, examine O que é CDC (captura de dados de alterações)?

Nome da coluna Tipo de dados Descrição
session_id int ID da sessão.

0 = os dados retornados nesta linha são uma agregação de todas as sessões desde que a instância do SQL Server foi iniciada pela última vez.
start_time datetime A hora em que a sessão foi iniciada.

Quando session_id = 0, a hora em que a coleta de dados agregados foi iniciada.
end_time datetime A hora em que a sessão foi encerrada.

NULL = a sessão está ativa.

Quando session_id = 0, a hora em que a última sessão foi encerrada.
duration int A duração da sessão em segundos.

0 = a sessão não contém transações do Change Data Capture.

Quando o session_id = 0, a soma da duração (em segundos) de todas as sessões com transações de captura de dados de alterações.
scan_phase nvarchar(200) A fase atual da sessão. Veja os valores possíveis e suas descrições:

1: configuração de leitura
2: primeiro exame, criando a tabela de hash
3: segundo exame
4: segundo exame
5: segundo exame
6: controle de versão do esquema
7: último segundo
8: concluído

Quando session_id = 0, esse valor é sempre "Aggregate".
error_count int Número de erros encontrados.

Quando session_id = 0, o número total de erros em todas as sessões.
start_lsn nvarchar(23) Iniciando LSN para a sessão.

Quando session_id = 0, o LSN inicial da última sessão.
current_lsn nvarchar(23) LSN atual sendo verificado.

Quando session_id = 0, o LSN atual é 0.
end_lsn nvarchar(23) Encerrando LSN para a sessão.

NULL = a sessão está ativa.

Quando session_id = 0, o LSN final da última sessão.
tran_count bigint Número de transações do Change Data Capture processadas. Este contador é populado na fase 2.

Quando session_id = 0, o número de transações processadas em todas as sessões.
last_commit_lsn nvarchar(23) LSN do último registro de log de confirmação processado.

Quando session_id = 0, o LSN do último registro de log de confirmação de qualquer sessão.
last_commit_time datetime Hora em que o último registro de log de confirmação foi processado.

Quando session_id = 0, a hora do último registro de log de confirmação de qualquer sessão.
log_record_count bigint Número de registros de log verificados.

Quando session_id = 0, o número de registros examinados em todas as sessões.
schema_change_count int Número de operações de linguagem de definição de dados (DDL) detectados. Este contador é populado na fase 6.

Quando session_id = 0, o número operações DDL processadas em todas as sessões.
command_count bigint Número de comandos processados.

Quando session_id = 0, o número de comandos processados em todas as sessões.
first_begin_cdc_lsn nvarchar(23) Primeiro LSN que contém transações do Change Data Capture.

Quando session_id = 0, o primeiro LSN que continha transações de captura de dados de alterações.
last_commit_cdc_lsn nvarchar(23) LSN do último registro de log de confirmação que contém transações do Change Data Capture.

Quando session_id = 0, o LSN do último registro de log de confirmação de qualquer sessão que continha transações de captura de dados de alterações
last_commit_cdc_time datetime Horário em que o último registro de log de confirmação foi processado que contém transações do Change Data Capture.

Quando session_id = 0, a hora do último registro de log de confirmação de qualquer sessão que continha transações de captura de dados de alterações.
latency int A diferença, em segundos, entre end_time e last_commit_cdc_time, na sessão. Este contador é populado no final da fase 7.

Quando session_id = 0, o último valor de latência diferente de zero registrado por uma sessão.
empty_scan_count int Número de sessões sucessivas que não contém nenhuma transação do Change Data Capture.
failed_sessions_count int Número de sessões que falharam.

Comentários

A sys.dm_cdc_log_scan_sessions DMV contém até 32 sessões de verificação e uma agregação de todas as sessões de verificação com session_id= 0. Portanto, a qualquer momento, essa exibição de gerenciamento dinâmico pode conter no máximo 33 linhas.

Permissões

Requer a permissão VIEW DATABASE STATE para consultar a exibição de gerenciamento dinâmico sys.dm_cdc_log_scan_sessions. Para obter mais informações sobre permissões nas exibições de gerenciamento dinâmico, confira Exibições e funções de gerenciamento dinâmico (Transact-SQL).

Permissões do SQL Server 2022 e posteriores

Requer a permissão VIEW DATABASE PERFORMANCE STATE no banco de dados.

Exemplos

O exemplo a seguir retorna informações da sessão mais atual.

USE AdventureWorks2022;  
GO  
SELECT session_id, start_time, end_time, duration, scan_phase,  
    error_count, start_lsn, current_lsn, end_lsn, tran_count,  
    last_commit_lsn, last_commit_time, log_record_count, schema_change_count,  
    command_count, first_begin_cdc_lsn, last_commit_cdc_lsn,   
    last_commit_cdc_time, latency, empty_scan_count, failed_sessions_count  
FROM sys.dm_cdc_log_scan_sessions  
WHERE session_id = (SELECT MAX(b.session_id) FROM sys.dm_cdc_log_scan_sessions AS b);  
GO

Próximas etapas