Compartilhar via


sys.database_connection_stats (Banco de Dados SQL do Azure)

Aplica-se a: Banco de Dados SQL do Azure

Contém estatísticas para eventos de conectividade de banco de dados do Banco de Dados SQL, fornecendo uma visão geral dos êxitos e falhas de conexão do banco de dados. Para obter mais informações sobre eventos de conectividade, consulte Tipos de evento no sys.event_log (Banco de Dados SQL do Azure).

Estatística Tipo Descrição
database_name sysname Nome do banco de dados.
start_time datetime2 Data e hora UTC do início do intervalo de agregação. A hora é sempre um múltiplo de 5 minutos. Por exemplo:

'2022-03-30 16:00:00'
'2022-03-30 16:05:00'
'2022-03-30 16:10:00'
end_time datetime2 Data e hora UTC do término do intervalo de agregação. End_time é sempre exatamente 5 minutos mais tarde do que o start_time correspondente na mesma linha.
success_count int Número de conexões bem-sucedidas.
total_failure_count int Número total de conexões com falha. Essa é a soma de connection_failure_count, terminated_connection_count e throttled_connection_count e não inclui eventos de deadlock.
connection_failure_count int Número de falhas de logon.
terminated_connection_count int Essa coluna não é usada e é preservada para compatibilidade com versões anteriores.
throttled_connection_count int Essa coluna não é usada e é preservada para compatibilidade com versões anteriores.

Comentários

Agregação de eventos

As informações de evento para esta exibição são coletadas e agregadas em intervalos de 5 minutos. As colunas de contagem representam o número de vezes que um evento de conectividade determinado ocorreu para um banco de dados específico dentro de um intervalo de tempo.

Por exemplo, se um usuário não conseguir se conectar ao banco de dados Database1 sete vezes entre 11:00 e 11:05 em 30 de março de 2022 (UTC), essas informações estarão disponíveis em uma única linha nesta exibição:

database_name start_time end_time success_count total_failure_count connection_failure_count terminated_connection_count throttled_connection_count
Database1 2022-03-30 11:00:00 2022-03-30 11:05:00 0 7 7 0 0

start_time e end_time do intervalo

Um evento é incluído em um intervalo de agregação quando o evento ocorre em ou após start_time e antes end_time para esse intervalo. Por exemplo, um evento que ocorre exatamente em 2022-03-30 19:25:00.0000000 seria incluído somente no segundo intervalo mostrado abaixo:

start_time                    end_time  
2022-03-30 19:20:00.0000000   2022-03-30 19:25:00.0000000  
2022-03-30 19:25:00.0000000   2022-03-30 19:30:00.0000000  

Atualizações de dados

Os dados nessa exibição são acumulados com o passar do tempo. Normalmente, os dados são acumulados em uma hora de início do intervalo de agregação, mas pode levar até um máximo de 24 horas para que todos os dados apareçam na exibição. Durante esse período, as informações em uma única linha podem ser atualizadas periodicamente.

Retenção de dados

Os dados nessa exibição são retidos por no máximo 30 dias, ou possivelmente menos, dependendo do número de bancos de dados e do número de eventos exclusivos que cada banco de dados gera. Para reter essas informações por um período mais longo, copie os dados em um banco de dados separado. Depois que você faz uma cópia inicial da exibição, as linhas na exibição podem ser atualizadas à medida que os dados são acumulados. Para manter sua cópia de dados atualizada, periodicamente faça uma verificação da tabela das linhas para procurar um aumento na contagem de eventos de linhas existentes e identificar novas linhas (você pode identificar linhas exclusivas usando a hora de início e de término) e, em seguida, atualize sua cópia dos dados com essas alterações.

Erros não incluídos

Essa exibição não pode incluir todas as informações de conexão e erro:

  • Essa exibição não inclui todos os erros de banco de dados do Banco de Dados SQL que podem ocorrer, apenas aqueles especificados em Tipos de Evento no sys.event_log (Banco de Dados SQL do Azure).
  • Se houver uma falha de computador no datacenter do Banco de Dados SQL, uma pequena quantidade de dados poderá estar ausente da tabela de eventos.
  • Se um endereço IP tiver sido bloqueado por meio do DoSGuard, os eventos de tentativa de conexão desse endereço IP não poderão ser coletados e não aparecerão nessa exibição.

Permissões

Requer permissão para acessar o banco de dados mestre no servidor lógico no Banco de Dados SQL do Azure.

Exemplos

Este exemplo consulta sys.database_connection_stats para retornar um resumo das conexões de banco de dados que ocorreram entre o meio-dia de 29 de março de 2022 e o meio-dia de 30 de março de 2022 (UTC). Conecte-se ao banco de dados mestre no servidor lógico no Banco de Dados SQL do Azure para executar a consulta.

SELECT database_name, start_time, end_time, success_count, total_failure_count, connection_failure_count
FROM sys.database_connection_stats
WHERE start_time>='2022-03-29 12:00:00' and end_time<='2022-03-30 12:00:00'
ORDER BY start_time ASC; 

Próximas etapas

Saiba mais sobre o Banco de Dados SQL do Azure nos seguintes artigos: