All rules

Schema

postgresql/require-named-constraint

Require explicit names on CHECK / UNIQUE / FK / EXCLUSION constraints.

  • Type suggestion
  • Recommended warn
  • Fixable no

Why this matters

PostgreSQL invents a name for unnamed constraints, but the generated name varies subtly across environments and migration tools, which makes later `DROP CONSTRAINT` / `ALTER CONSTRAINT` statements brittle. Column-level `NOT NULL` and `PRIMARY KEY` are allowed without explicit names.

Examples

Incorrect

Incorrect
CREATE TABLE items (id int, code text, UNIQUE (code));
Incorrect
ALTER TABLE items ADD CHECK (length(code) > 0);

Correct

Correct
CREATE TABLE items (
  id int,
  code text,
  CONSTRAINT items_code_unique UNIQUE (code)
);
Correct
ALTER TABLE items ADD CONSTRAINT items_code_non_empty CHECK (length(code) > 0);

Configure it

// eslint.config.js
import postgresql from "eslint-plugin-postgresql";

export default [
  {
    files: ["**/*.sql"],
    languageOptions: {
      parser: postgresql.configs.recommended.languageOptions.parser,
    },
    plugins: { postgresql },
    rules: {
      "postgresql/require-named-constraint": "warn",
    },
  },
];

Options

This rule has no options.

Try this rule

Edit the SQL — only require-named-constraint is enabled.

Pre-filled with the first incorrect example. Toggle off in the rule shelf to see how the diagnostic disappears.

0 errors 0 warnings parse 0ms · rules 0ms
Diagnostics

No issues found.

2 rules enabled.

Rule under test require-named-constraint — plus no-syntax-error as a safety net.
eslint-plugin-postgresql

An ESLint plugin that lints .sql files with real PostgreSQL grammar and a curated set of best-practice rules.

© 2026 eslint-plugin-postgresql contributors Built on libpg-query · PostgreSQL 17