• Article

TruncateLogOnCheckpoint Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The TruncateLogOnCheckpoint property configures automatic transaction log maintenance activity.

Syntax

object
.TruncateLogOnCheckpoint [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetTruncateLogOnCheckpoint(LPBOOL pRetVal);
HRESULT SetTruncateLogOnCheckpoint(BOOL NewValue);

Remarks

Periodically, and on certain user-directed actions, Microsoft SQL Server forces a write of dirty pages, ensuring data integrity at a point in time. The recovery interval option configures periodic dirty page writes. The Transact-SQL statement CHECKPOINT and other user-directed actions, such as initiating a complete database backup, force a dirty page write.

If TRUE, SQL Server removes log entries referencing committed transactions when activity on the database forces a dirty page write.

If FALSE, the forced dirty page writes have no effect on the database transaction log.

Important

Setting the TruncateLogOnCheckpoint property to TRUE implies that backup-maintained database integrity relies on backup of the database only. If TRUE, you cannot back up a database transaction log, and backup strategies based on differential backup of the log are not available. For more information, see Setting Database Options.

Applies To:

DBOption Object