↑↓ select ↵ open ⌫ change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

SQL Commands / Maintenance

force a write-ahead log checkpoint

Reading PG 18current·documented in 27 of 30 versions, 7.1 to 20

Syntax

CHECKPOINT
Syntax diagrams

Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.

CHECKPOINT

Description

A checkpoint is a point in the write-ahead log sequence at which all data files have been updated to reflect the information in the log. All data files will be flushed to disk. Refer to Section 28.5 for more details about what happens during a checkpoint.

The CHECKPOINT command forces an immediate checkpoint when the command is issued, without waiting for a regular checkpoint scheduled by the system (controlled by the settings in Section 19.5.2). CHECKPOINT is not intended for use during normal operation.

If executed during recovery, the CHECKPOINT command will force a restartpoint (see Section 28.5) rather than writing a new checkpoint.

Only superusers or users with the privileges of the pg_checkpoint role can call CHECKPOINT.

Compatibility

The CHECKPOINT command is a PostgreSQL language extension.

Version history 16
  1. 18 → 19 changed
  2. 16 → 17 changed
  3. 14 → 15 changed
  4. 13 → 14 changed
  5. 11 → 12 changed
  6. 9.6 → 10 changed
  7. 9.5 → 9.6 changed
  8. 9.1 → 9.2 changed
  9. 8.4 → 9.0 changed
  10. 8.2 → 8.3 changed
  11. 8.1 → 8.2 changed
  12. 8.0 → 8.1 changed
  13. 7.4 → 8.0 changed
  14. 7.3 → 7.4 changed
  15. 7.1 → 7.2 changed
  16. 7.0 → 7.1 added

Definition snapshot: b7bd9cda · English manual source