Classe SqlErrorLogFile

Aplica-se a: SQL Server

Fornece propriedades para visualizar informação sobre um ficheiro de registo do SQL Server.

Syntax

class SQLErrorLogFile
{
    uint32ArchiveNumber;
    stringInstanceName;
    datetimeLastModified;
    uint32LogFileSize;
    stringName;
};

Propriedades

A classe SQLErrorLogFile define as seguintes propriedades.

Property Description
Arquivo Número Tipo de dados: uint32

Tipo de acesso: Somente leitura

O número de arquivo do ficheiro de registo.
Nome da Instância Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Chave

O nome da instância do SQL Server onde reside o ficheiro de registo.
Última modificação Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data em que o ficheiro de registo foi modificado pela última vez.
LogFileSize Tipo de dados: uint32

Tipo de acesso: Somente leitura

O tamanho do ficheiro de log, em bytes.
Nome Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Chave

O nome do ficheiro de registo.

Observações

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

Example

O exemplo seguinte recupera informações sobre todos os ficheiros de registo do SQL Server numa instância específica 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

Comments

Quando o InstanceName não é fornecido na instrução WQL, a consulta devolve informação para a instância por defeito. Por exemplo, a seguinte instrução WQL devolve informação sobre todos os ficheiros de registo da instância padrão (MSSQLSERVER).

"SELECT * FROM SqlErrorLogFile"

Segurança

Para se ligar a um ficheiro de registo do SQL Server através do WMI, deve ter as seguintes permissões tanto no computador local como no remoto:

  • Acesso de leitura ao namespace Root\Microsoft\SqlServer\ComputerManagement10 WMI. Por padrão, todos têm acesso de leitura por meio da permissão Habilitar conta.

    Note

    Para informações sobre como verificar permissões WMI, consulte a secção de Segurança do tópico Ver Ficheiros de Registo Offline.

  • Permissão de leitura para a pasta que contém os registos de erro. Por defeito, os registos de erro estão localizados no seguinte caminho (onde <Drive> representa o disco onde instalou o SQL Server e <InstanceName> é o nome da instância do SQL Server):

    <Drive>:\Program Files\Microsoft SQL Server\MSSQL11.<NomeInstância>\MSSQL\Log

Se estiver a ligar-se através de um firewall, certifique-se de que está definida uma exceção no firewall para WMI em computadores alvo remotos. Para mais informações, consulte Ligação Remota ao WMI a partir do Windows Vista.