Classe SqlErrorLogFile
Aplica-se a: SQL Server
Fornece propriedades para exibir informações sobre um arquivo de log do SQL Server.
Sintaxe
class SQLErrorLogFile
{
uint32ArchiveNumber;
stringInstanceName;
datetimeLastModified;
uint32LogFileSize;
stringName;
};
Propriedades
A classe SQLErrorLogFile define as propriedades a seguir.
Propriedade | Descrição |
---|---|
Número do arquivo | Tipo de dados: uint32 Tipo de acesso: Somente leitura O número do arquivo morto do arquivo de log. |
InstanceName | Tipo de dados: string Tipo de acesso: Somente leitura Qualificadores: Key O nome da instância do SQL Server em que o arquivo de log reside. |
LastModified | Tipo de dados: datetime Tipo de acesso: Somente leitura A data da última modificação do arquivo de log. |
LogFileSize | Tipo de dados: uint32 Tipo de acesso: Somente leitura O tamanho do arquivo de log, em bytes. |
Nome | Tipo de dados: string Tipo de acesso: Somente leitura Qualificadores: Key O nome do arquivo de log. |
Comentários
Tipo | Nome |
---|---|
MOF | - sqlmgmprovider.mof (SQL Server 2022 (16.x) e versões posteriores)- sqlmgmproviderxpsp2up.mof (SQL Server 2019 (15.x) e versões anteriores) |
DLL | sqlmgmprovider.dll |
Namespace | \root\Microsoft\SqlServer\ComputerManagement10 |
Exemplo
O exemplo a seguir recupera informações sobre todos os arquivos de log do SQL Server em uma instância especificada do SQL Server. Para executar o exemplo, substitua <Instance_Name> pelo nome da instância, por exemplo, 'Instance1'.
on error resume next
set strComputer = "."
set objWMIService = GetObject("winmgmts:\\.\root\Microsoft\SqlServer\ComputerManagement10")
set LogFiles = objWmiService.ExecQuery("SELECT * FROM SqlErrorLogFile WHERE InstanceName = '<Instance_Name>'")
For Each logFile in LogFiles
WScript.Echo "Instance Name: " & logFile.InstanceName & vbNewLine _
& "Log File Name: " & logFile.Name & vbNewLine _
& "Archive Number: " & logFile.ArchiveNumber & vbNewLine _
& "Log File Size: " & logFile.LogFileSize & " bytes" & vbNewLine _
& "Last Modified: " & logFile.LastModified & vbNewLine _
Next
Comentários
Quando InstanceName não é fornecido na instrução WQL, a consulta retorna informações para a instância padrão. Por exemplo, a instrução WQL a seguir retorna informações sobre todos os arquivos de log da instância padrão (MSSQLSERVER).
"SELECT * FROM SqlErrorLogFile"
Segurança
Para se conectar a um arquivo de log do SQL Server por meio do WMI, você deve ter as seguintes permissões nos computadores local e remoto:
Acesso de leitura ao namespace WMI Root\Microsoft\SqlServer\ComputerManagement10 . Por padrão, todos usuários têm acesso de leitura por meio da permissão Habilitar Conta.
Observação
Para obter informações sobre como verificar as permissões do WMI, consulte a seção Segurança do tópico Exibir arquivos de log offline.
Permissão de leitura para a pasta que contém os logs de erros. Por padrão, os logs de erros estão localizados no seguinte caminho (em que <Drive> representa a unidade em que você instalou o SQL Server e <InstanceName> é o nome da instância do SQL Server):
<Unidade>:\Arquivos de Programas\Microsoft SQL Server\MSSQL11 .<InstanceName>\MSSQL\Log
Se você estiver se conectando por meio de um firewall, verifique se uma exceção está definida no firewall para WMI em computadores de destino remotos. Para obter mais informações, consulte Conectando-se ao WMI remotamente a partir do Windows Vista.