managed_backup.fn_get_health_status (Transact-SQL)

Artigo
07/05/2024

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Retorna uma tabela 0, uma ou mais linhas de contagem agregada dos erros relatados pelos Eventos Estendidos por um período especificado.

A função é usada para relatar o status de integridade dos serviços no Smart Admin. Atualmente, o backup gerenciado do SQL Server no Microsoft Azure tem suporte no guarda-chuva do Smart Admin. Portanto, os erros retornados estão relacionados ao backup gerenciado do SQL Server no Microsoft Azure.

Convenções de sintaxe de Transact-SQL

Sintaxe

managed_backup.fn_get_health_status([@begin_time = ] 'time_1' , [ @end_time = ] 'time_2')

Argumentos

[@begin_time]
O início do período a partir do qual a contagem agregada de erros é calculada. O @begin_time parâmetro é DATETIME. O valor padrão é NULL. Quando o valor for NULL, a função processará os eventos reportados a partir de 30 minutos antes da hora atual.

@end_time[ ]
O fim do período a partir do qual a contagem agregada de erros é calculada. O @end_time parâmetro é DATETIME com um valor padrão de NULL. Quando o valor for NULL, a função processará os eventos estendidos até a hora atual.

Tabela retornada

Nome da Coluna	Tipo de Dados	Descrição
number_of_storage_connectivity_errors	int	Número de erros de conexão quando o programa se conecta à conta de armazenamento do Azure.
number_of_sql_errors	int	O número de erros retornados quando o programa se conectar ao SQL Server Engine.
number_of_invalid_credential_errors	int	O número de erros retornados quando o programa tentar realizar a autenticação usando Credenciais SQL.
number_of_other_errors	int	Número de erros em outras categorias, além de conectividade, SQL ou credencial.
number_of_corrupted_or_deleted_backups	int	Número de arquivos de backup excluídos ou corrompidos.
number_of_backup_loops	int	O número de vezes que o agente de backup verifica todos os bancos de dados configurados com o backup gerenciado do SQL Server no Microsoft Azure.
number_of_retention_loops	int	O número de vezes que os bancos de dados são verificados para avaliar o período de retenção definido.

Práticas Recomendadas

Essas contagens agregadas podem ser usadas para monitorar a integridade do sistema. Por exemplo, se a coluna number_ of_retention_loops for 0 por 30 minutos, possivelmente o gerenciamento de retenção está demorando ou talvez nem esteja funcionando corretamente. As colunas de erro diferentes de zero podem indicar problemas, e os logs dos Eventos estendidos devem ser verificados para detectar qualquer problema. Como alternativa, use o procedimento armazenado managed_backup.sp_get_backup_diagnostics para obter uma lista de eventos estendidos para encontrar os detalhes do erro.

Segurança

Permissões

Requer permissões SELECT na função.

Exemplos

O exemplo a seguir retorna contagens de erro agregadas referentes aos últimos 30 minutos a partir do momento em que foram executadas.
```
SELECT *  
FROM managed_backup.fn_get_health_status(NULL, NULL)  
```

O exemplo a seguir retorna as contagens de erro agregadas referente à semana atual:

Use msdb  
Go  
DECLARE @startofweek datetime  
DECLARE @endofweek datetime  
SET @startofweek = DATEADD(Day, 1-DATEPART(WEEKDAY, CURRENT_TIMESTAMP), CURRENT_TIMESTAMP)   
SET @endofweek = DATEADD(Day, 7-DATEPART(WEEKDAY, CURRENT_TIMESTAMP), CURRENT_TIMESTAMP)  
SELECT *  
FROM managed_backup.fn_get_health_status(@startofweek, @endofweek)

Compartilhar via