// Referencia de errores de SQL Server

Error 9002 de SQL Server: el registro de transacciones de la base de datos está lleno

El archivo de registro de la base de datos está lleno y no puede crecer, por lo que las escrituras fallan. La razón del mensaje (LOG_BACKUP, ACTIVE_TRANSACTION...) indica lo que impide que el registro se reutilice.

Número de error
9002
Gravedad
17
Categoría
Memoria, registro y almacenamiento
Mensaje de error
The transaction log for database '%ls' is full due to '%ls' and the holdup lsn is %S_LSN.

Qué significa

SQL Server escribe cada cambio en el registro de transacciones antes de modificar los datos. El espacio del registro se reutiliza solo cuando ya nada lo necesita: en el modelo de recuperación completa eso significa tras una copia de seguridad del registro, y en cualquier modelo la transacción abierta más antigua, la replicación o una réplica de un grupo de disponibilidad pueden retenerlo. Si el registro no puede reutilizarse ni crecer (alcanzó su tamaño máximo o el disco está lleno), cada escritura falla con 9002.

El mensaje indica el motivo, que es el mismo valor que log_reuse_wait_desc en sys.databases.

Causas comunes

  • LOG_BACKUP: la base de datos está en el modelo de recuperación completa o de registro masivo y no se están realizando copias de seguridad del registro.
  • ACTIVE_TRANSACTION: una transacción abierta de larga duración o olvidada bloquea el registro.
  • REPLICATION o AVAILABILITY_REPLICA: un lector de registro o una réplica secundaria se ha quedado atrás.
  • El archivo de registro tiene un tamaño máximo fijo, o el disco que lo contiene está lleno.
  • Una sola transacción enorme, como eliminar millones de filas en una sola instrucción.

Cómo solucionarlo

  1. Ve por qué no se puede reutilizar el registro.

    SELECT name, recovery_model_desc, log_reuse_wait_desc FROM sys.databases WHERE name = N'SalesDb';
  2. Para LOG_BACKUP, haz copias de seguridad del registro (y prográmalas).

    BACKUP LOG SalesDb TO DISK = N'D:\Backup\SalesDb_log.trn';
  3. Para ACTIVE_TRANSACTION, encuentra la transacción abierta más antigua y haz que se confirme o se revierta.

    DBCC OPENTRAN (N'SalesDb');
  4. Da espacio al registro: deja que crezca, o añade un segundo archivo de registro en otro disco.

    ALTER DATABASE SalesDb MODIFY FILE (NAME = SalesDb_log, MAXSIZE = UNLIMITED, FILEGROWTH = 512MB);
  5. Divide los cambios de datos grandes en lotes para que cada transacción sea pequeña.

    WHILE 1 = 1
    BEGIN
        DELETE TOP (10000) FROM dbo.EventLog WHERE CreatedAt < '2024-01-01';
        IF @@ROWCOUNT = 0 BREAK;
    END;
  6. Si esta base de datos no necesita restauración a un momento dado, el modelo de recuperación simple reutiliza el espacio del registro tras cada punto de control.

    ALTER DATABASE SalesDb SET RECOVERY SIMPLE;

Preguntas

¿Debería reducir el archivo de registro después de corregir el error 9002?

Solo si creció muy por encima de su tamaño normal por un evento puntual. Reducir un registro que normalmente necesita ese espacio solo hace que vuelva a crecer, y cuesta tiempo mientras las escrituras esperan.

Errores relacionados

Más errores de memoria, registro y almacenamiento

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQL Server en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQL Server y las demás bases de datos que uses.