// Referência de erro do SQL Server

Erro do SQL Server 9002: O log de transações do banco de dados está cheio

O arquivo de log do banco de dados está cheio e não pode crescer, então gravações falham. O motivo da mensagem (LOG_BACKUP, ACTIVE_TRANSACTION...) indica o que impede o log de ser reutilizado.

Número do erro
9002
Gravidade
17
Categoria
Memória, log e armazenamento
Mensagem de erro
The transaction log for database '%ls' is full due to '%ls' and the holdup lsn is %S_LSN.

O que significa

O SQL Server grava toda alteração no log de transações antes de modificar os dados. O espaço do log é reutilizado apenas quando nada mais precisa dele: no modelo de recuperação completa, isso significa após um backup do log, e em qualquer modelo a transação aberta mais antiga, a replicação ou uma réplica de grupo de disponibilidade podem retê-lo. Se o log não puder ser reutilizado e não puder crescer (atingiu o tamanho máximo ou o disco está cheio), toda gravação falha com 9002.

A mensagem informa o motivo, que é o mesmo valor que log_reuse_wait_desc em sys.databases.

Causas comuns

  • LOG_BACKUP: o banco de dados está no modelo de recuperação completa ou bulk-logged e backups de log não estão sendo feitos.
  • ACTIVE_TRANSACTION: uma transação aberta de longa duração ou esquecida mantém o log preso.
  • REPLICATION ou AVAILABILITY_REPLICA: um leitor de log ou uma réplica secundária ficou para trás.
  • O arquivo de log tem um tamanho máximo fixo, ou o disco que o contém está cheio.
  • Uma única transação enorme, como deletar milhões de linhas em uma única instrução.

Como corrigir

  1. Veja por que o log não pode ser reutilizado.

    SELECT name, recovery_model_desc, log_reuse_wait_desc FROM sys.databases WHERE name = N'SalesDb';
  2. Para LOG_BACKUP, faça um backup do log (e agende-os).

    BACKUP LOG SalesDb TO DISK = N'D:\Backup\SalesDb_log.trn';
  3. Para ACTIVE_TRANSACTION, encontre a transação aberta mais antiga e faça o commit ou o rollback dela.

    DBCC OPENTRAN (N'SalesDb');
  4. Dê espaço ao arquivo de log: deixe-o crescer ou adicione um segundo arquivo de log em outro disco.

    ALTER DATABASE SalesDb MODIFY FILE (NAME = SalesDb_log, MAXSIZE = UNLIMITED, FILEGROWTH = 512MB);
  5. Divida grandes alterações de dados em lotes para que cada transação seja pequena.

    WHILE 1 = 1
    BEGIN
        DELETE TOP (10000) FROM dbo.EventLog WHERE CreatedAt < '2024-01-01';
        IF @@ROWCOUNT = 0 BREAK;
    END;
  6. Se você não precisa de restauração para um momento específico neste banco de dados, o modelo de recuperação simples reutiliza o espaço do log após cada ponto de verificação.

    ALTER DATABASE SalesDb SET RECOVERY SIMPLE;

Perguntas

Devo reduzir o arquivo de log após corrigir o 9002?

Apenas se ele tiver crescido muito além do tamanho normal devido a um evento único. Reduzir um log que regularmente precisa desse espaço apenas fará com que ele cresça novamente, o que custa tempo enquanto as escritas aguardam.

Erros relacionados

Mais erros de memória, log e armazenamento

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQL Server no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQL Server e os outros bancos de dados que você usa.