TruncateLogOnCheckpoint Property (SQL-DMO)

The TruncateLogOnCheckpoint property configures automatic transaction log maintenance activity.

Applies To

Syntax

object.TruncateLogOnCheckpoint [= value]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	True or False

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, forces 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. When True, you cannot backup a database transaction log and backup strategies based on incremental backup of the log are not available. For more information, see Setting Database Options.

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetTruncateLogOnCheckpoint(LPBOOL pRetVal);

HRESULT SetTruncateLogOnCheckpoint(BOOL NewValue);