sp_readerrorlog (Transact-SQL)

Artikel
12/22/2023

Ermöglicht ihnen, den Inhalt der SQL Server- oder SQL Server-Agent Fehlerprotokolldatei zu lesen und nach Schlüsselwort (keyword) zu filtern.

Transact-SQL-Syntaxkonventionen

Syntax

sp_readerrorlog  
    @p1        int = 0,
    @p2        int = NULL,
    @p3        nvarchar(4000) = NULL,
    @p4        nvarchar(4000) = NULL

Argumente

[@p1 = ] "log_number"

Ist der Ganzzahlwert (int) des Protokolls, das Sie anzeigen möchten. Das aktuelle Fehlerprotokoll hat den Wert 0, der vorherige ist 1 (Errorlog.1), der vor dem vorherigen ist 2 (Errorlog.2) usw.

[@p2 = ] "Produkt-ID"

Ist der ganzzahlige Wert (int) für das Produkt, dessen Protokoll Sie anzeigen möchten. Verwenden Sie 1 für SQL Server oder 2 SQL Server-Agent. Wenn kein Wert angegeben ist, wird das SQL Server-Produkt verwendet.

[@p3 = ] "string_to_search"

Ist der Zeichenfolgenwert für eine Zeichenfolge, nach der sie beim Anzeigen des Fehlerprotokolls filtern möchten. Dieser Wert ist nvarchar(4000) und hat einen Standardwert von NULL.

[@p4 = ] "string_to_search"

Ist der Zeichenfolgenwert für eine zusätzliche Zeichenfolge, nach der Sie filtern möchten, um die Suche beim Anzeigen des Fehlerprotokolls weiter zu verfeinern. Dieser Wert ist nvarchar(4000) und hat einen Standardwert von NULL. Dadurch wird ein zusätzlicher Filter für die erste Zeichenfolgensuche bereitgestellt @p3.

Rückgabecodewerte

Kein Rückgabecode

Resultsets

Zeigt den Inhalt des angeforderten Fehlerprotokolls an. Wenn Filterzeichenfolgen verwendet werden, werden nur die Zeilen angezeigt, die diesen Zeichenfolgen entsprechen.

Hinweise

Jedes Mal, wenn SQL Server gestartet wird, wird das aktuelle Fehlerprotokoll in "errorlog.1" umbenannt. errorlog.1 wird "errorlog.2", "errorlog.2" wird "errorlog.3" usw. mit sp_readerrorlog können Sie eine dieser Fehlerprotokolldateien lesen, solange die Dateien vorhanden sind.

Berechtigungen

Ausführungsberechtigungen für sp_readerrorlog sind auf Mitglieder der festen Serverrolle "sysadmin " beschränkt.

Beispiele

Im folgenden Beispiel wird das SQL Server-Fehlerprotokoll gezyklent.

.A Lesen des aktuellen SQL Server-Fehlerprotokolls

EXEC sp_readerrorlog;

B. Anzeigen des vorherigen SQL Server-Agent Fehlerprotokolls

exec sp_readerrorlog 1, 2;

C. Suchen von Protokollmeldungen, die angeben, dass eine Datenbank gestartet wird

exec sp_readerrorlog 0, 1, 'database', 'start'