banTruncate

Diagnostic Category: lint/safety/banTruncate

Since: vnext

Sources: - Inspired from: pgfence/truncate

Description

Truncating a table removes all rows and can cause data loss in production.

TRUNCATE is a fast, non-transactional (in terms of row-level locking) way to remove all data from a table. It acquires an ACCESS EXCLUSIVE lock and cannot be safely rolled back in all scenarios. In a migration context, this is almost always a mistake.

Examples

Invalid

truncate my_table;

code-block.sql:1:1 lint/safety/banTruncate ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  × Truncating a table removes all rows and can cause data loss.

  > 1 │ truncate my_table;
      │ ^^^^^^^^^^^^^^^^^^
    2 │ 

  i Use DELETE with a WHERE clause instead, or ensure this is intentional and not part of a migration.

Valid

delete from my_table where expired_at < now();

How to configure

{
  "linter": {
    "rules": {
      "safety": {
        "banTruncate": "error"
      }
    }
  }
}