Why this matters
`ALTER TABLE ... ADD CONSTRAINT ... UNIQUE (...)` builds the unique index inline under `ACCESS EXCLUSIVE`. The lock-friendly form is to build the index out-of-band with `CREATE UNIQUE INDEX CONCURRENTLY`, then promote it via `ADD CONSTRAINT ... UNIQUE USING INDEX <name>`. Non-UNIQUE constraints are out of scope.
Examples
Incorrect
ALTER TABLE t ADD CONSTRAINT uq_t_email UNIQUE (email);Correct
CREATE UNIQUE INDEX CONCURRENTLY idx_t_email ON t (email);
ALTER TABLE t ADD CONSTRAINT uq_t_email UNIQUE USING INDEX idx_t_email;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/no-add-unique-constraint-directly": "error",
},
},
]; Options
Edit the SQL — only no-add-unique-constraint-directly is enabled.
Pre-filled with the first incorrect example. Toggle off in the rule shelf to see how the diagnostic disappears.
Diagnostics
No issues found.
2 rules enabled.
Rule under test
no-add-unique-constraint-directly — plus no-syntax-error as a safety net.