// SQL Server-Fehlerreferenz

SQL Server-Fehler 9002: Transaktionsprotokoll für Datenbank ist voll

Die Protokolldatei der Datenbank ist voll und kann nicht wachsen, daher schlagen Schreibvorgänge fehl. Der Grund der Meldung (LOG_BACKUP, ACTIVE_TRANSACTION...) gibt an, was verhindert, dass das Protokoll wiederverwendet wird.

Fehlernummer
9002
Schweregrad
17
Kategorie
Arbeitsspeicher, Protokoll und Speicherplatz
Fehlermeldung
The transaction log for database '%ls' is full due to '%ls' and the holdup lsn is %S_LSN.

Was es bedeutet

SQL Server schreibt jede Änderung zuerst in das Transaktionsprotokoll, bevor er die Daten ändert. Protokollplatz wird erst wiederverwendet, wenn ihn niemand mehr braucht: Im vollständigen Wiederherstellungsmodell heißt das nach einer Protokollsicherung, und in jedem Modell können die älteste offene Transaktion, die Replikation oder ein Availability-Group-Replikat ihn belegen. Wenn das Protokoll weder wiederverwendet noch vergrößert werden kann (es hat seine maximale Größe erreicht oder die Festplatte ist voll), schlägt jeder Schreibvorgang mit 9002 fehl.

Die Meldung nennt den Grund, der denselben Wert hat wie log_reuse_wait_desc in sys.databases.

Häufige Ursachen

  • LOG_BACKUP: die Datenbank verwendet das vollständige oder massenprotokollierte Wiederherstellungsmodell, und es werden keine Protokollsicherungen erstellt.
  • ACTIVE_TRANSACTION: Eine lang laufende oder vergessene offene Transaktion blockiert das Protokoll.
  • REPLICATION oder AVAILABILITY_REPLICA: ein Protokollleser oder ein sekundäres Replikat ist in Rückstand geraten.
  • Die Protokolldatei hat eine feste maximale Größe oder die Festplatte, auf der sie liegt, ist voll.
  • Eine einzelne riesige Transaktion, wie das Löschen von Millionen Zeilen in einer Anweisung.

Wie du es behebst

  1. Nachsehen, warum das Protokoll nicht wiederverwendet werden kann.

    SELECT name, recovery_model_desc, log_reuse_wait_desc FROM sys.databases WHERE name = N'SalesDb';
  2. Für LOG_BACKUP, nimm eine Protokollsicherung (und plane sie ein).

    BACKUP LOG SalesDb TO DISK = N'D:\Backup\SalesDb_log.trn';
  3. Für ACTIVE_TRANSACTION, finde die älteste offene Transaktion und bring sie zum Abschluss oder rolle sie zurück.

    DBCC OPENTRAN (N'SalesDb');
  4. Gib dem Protokoll Raum: Lass es wachsen oder füge eine zweite Protokolldatei auf einer anderen Festplatte hinzu.

    ALTER DATABASE SalesDb MODIFY FILE (NAME = SalesDb_log, MAXSIZE = UNLIMITED, FILEGROWTH = 512MB);
  5. Teile riesige Datenänderungen in Batches auf, damit jede Transaktion klein bleibt.

    WHILE 1 = 1
    BEGIN
        DELETE TOP (10000) FROM dbo.EventLog WHERE CreatedAt < '2024-01-01';
        IF @@ROWCOUNT = 0 BREAK;
    END;
  6. Wenn du für diese Datenbank keine Point-in-Time-Wiederherstellung brauchst, nutzt das einfache Wiederherstellungsmodell den Protokollplatz nach jedem Checkpoint wieder.

    ALTER DATABASE SalesDb SET RECOVERY SIMPLE;

Fragen

Soll ich die Protokolldatei nach der Behebung von 9002 verkleinern?

Nur wenn sie wegen eines einmaligen Ereignisses weit über ihre normale Größe hinausgewachsen ist. Ein Protokoll, das diesen Platz regelmäßig braucht, wächst nach dem Verkleinern einfach wieder – was Zeit kostet, während Schreibvorgänge warten.

Zugehörige Fehler

Weitere Arbeitsspeicher-, Protokoll- und Speicherplatzfehler

Der Code und der Meldungstext stammen aus der Microsoft Database Engine-Ereignisse und Fehlernachschlagewerk. Durchstöbere die vollständige SQL Server-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQL Server in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQL Server und die anderen Datenbanken, mit denen du arbeitest.