pgsafe 0.11.0

Static safety linter for PostgreSQL DDL migrations — catches unsafe schema changes before they lock or break production.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use crate::ast::NodeEnum;

use super::Rule;
use crate::{RuleHit, Severity};

pub struct ReindexNonConcurrent;

impl Rule for ReindexNonConcurrent {
    fn id(&self) -> &'static str {
        "reindex-non-concurrent"
    }
    fn severity(&self) -> Severity {
        Severity::Error
    }
    fn check(&self, node: &NodeEnum, out: &mut Vec<RuleHit>) {
        if let NodeEnum::ReindexStmt(r) = node {
            let concurrent = r.params.iter().any(|p| {
                matches!(p.node.as_ref(), Some(NodeEnum::DefElem(de))
                    if de.defname == "concurrently" && super::defelem_is_true(de))
            });
            if !concurrent {
                // Map the reindex target type to the keyword CONCURRENTLY must follow.
                // REINDEX SYSTEM and Undefined do not support CONCURRENTLY.
                let kw = match crate::ast::protobuf::ReindexObjectType::try_from(r.kind) {
                    Ok(crate::ast::protobuf::ReindexObjectType::ReindexObjectIndex) => {
                        Some("INDEX")
                    }
                    Ok(crate::ast::protobuf::ReindexObjectType::ReindexObjectTable) => {
                        Some("TABLE")
                    }
                    Ok(crate::ast::protobuf::ReindexObjectType::ReindexObjectSchema) => {
                        Some("SCHEMA")
                    }
                    Ok(crate::ast::protobuf::ReindexObjectType::ReindexObjectDatabase) => {
                        Some("DATABASE")
                    }
                    _ => None, // System / Undefined: no legal CONCURRENTLY form
                };
                out.push(RuleHit {
                    message: "REINDEX without CONCURRENTLY takes an ACCESS EXCLUSIVE lock on each index it \
                              rebuilds, blocking writes (and reads through that index)."
                        .into(),
                    guidance: "Use REINDEX INDEX CONCURRENTLY (PG12+, outside a transaction); on older \
                               servers use pg_repack or a maintenance window."
                        .into(),
                    fix: kw.map(|kw| crate::fix::FixDraft {
                        title: "Add CONCURRENTLY",
                        edits: vec![crate::fix::FixDraftEdit {
                            anchor: crate::fix::FixAnchor::AfterKeyword(kw),
                            replacement: " CONCURRENTLY".into(),
                        }],
                    }),
                });
            }
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::{lint_sql, LintOptions};

    fn findings(sql: &str) -> Vec<crate::Finding> {
        lint_sql(sql, &LintOptions::default()).unwrap()
    }

    #[test]
    fn flags_plain_reindex_index() {
        assert!(findings("REINDEX INDEX idx")
            .iter()
            .any(|f| f.rule_id == "reindex-non-concurrent"));
    }

    #[test]
    fn ignores_concurrent_reindex_index() {
        assert!(findings("REINDEX INDEX CONCURRENTLY idx")
            .iter()
            .all(|f| f.rule_id != "reindex-non-concurrent"));
    }

    #[test]
    fn emits_a_concurrently_fix() {
        use crate::fix::apply;
        let sql = "REINDEX INDEX idx;";
        let fs = findings(sql);
        let f = fs
            .iter()
            .find(|f| f.rule_id == "reindex-non-concurrent")
            .unwrap();
        let fix = f.fix.as_ref().expect("fix present");
        assert_eq!(fix.title, "Add CONCURRENTLY");
        let fixed = apply(sql, &fix.edits);
        assert_eq!(fixed, "REINDEX INDEX CONCURRENTLY idx;");
        // Applying it clears the finding.
        assert!(findings(&fixed)
            .iter()
            .all(|f| f.rule_id != "reindex-non-concurrent"));
    }

    #[test]
    fn reindex_system_has_no_fix() {
        let fs = findings("REINDEX SYSTEM mydb;");
        let f = fs
            .iter()
            .find(|f| f.rule_id == "reindex-non-concurrent")
            .expect("rule must fire for REINDEX SYSTEM");
        assert!(f.fix.is_none(), "REINDEX SYSTEM must not produce a fix");
    }

    #[test]
    fn emits_a_concurrently_fix_for_table() {
        use crate::fix::apply;
        let sql = "REINDEX TABLE t;";
        let fs = findings(sql);
        let f = fs
            .iter()
            .find(|f| f.rule_id == "reindex-non-concurrent")
            .expect("rule must fire for REINDEX TABLE");
        let fix = f.fix.as_ref().expect("fix present");
        assert_eq!(fix.title, "Add CONCURRENTLY");
        let fixed = apply(sql, &fix.edits);
        assert_eq!(fixed, "REINDEX TABLE CONCURRENTLY t;");
        assert!(findings(&fixed)
            .iter()
            .all(|f| f.rule_id != "reindex-non-concurrent"));
    }
}