Skip to content
pglinter

pglinter

pglinter : PostgreSQL Linting and Analysis Extension

Overview

ID Extension Package Version Category License Language
5090
pglinter
pglinter
1.1.2
ADMIN
PostgreSQL
Rust
Attribute Has Binary Has Library Need Load Has DDL Relocatable Trusted
--s-dt-
No
Yes
No
Yes
no
yes
Relationships
See Also
amcheck
supautils

manually upgraded PGRX from 0.16.1 to 0.17.0 by Vonng

Packages

Type Repo Version PG Major Compatibility Package Pattern Dependencies
EXT
PIGSTY
1.1.2
18
17
16
15
14
pglinter -
RPM
PIGSTY
1.1.2
18
17
16
15
14
pglinter_$v -
DEB
PIGSTY
1.1.2
18
17
16
15
14
postgresql-$v-pglinter -
Linux / PG PG18 PG17 PG16 PG15 PG14
el8.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
el8.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
el9.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
el9.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
el10.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
el10.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
d12.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
d12.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
d13.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
d13.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
u22.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
u22.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
u24.x86_64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
u24.aarch64
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
PIGSTY 1.1.2
u26.x86_64
MISS
MISS
MISS
MISS
MISS
u26.aarch64
MISS
MISS
MISS
MISS
MISS
Package Version OS ORG SIZE File URL
pglinter_18 1.1.2 el8.x86_64 pigsty 587.9 KiB pglinter_18-1.1.2-1PIGSTY.el8.x86_64.rpm
pglinter_18 1.1.2 el8.aarch64 pigsty 449.1 KiB pglinter_18-1.1.2-1PIGSTY.el8.aarch64.rpm
pglinter_18 1.1.2 el9.x86_64 pigsty 601.7 KiB pglinter_18-1.1.2-1PIGSTY.el9.x86_64.rpm
pglinter_18 1.1.2 el9.aarch64 pigsty 477.2 KiB pglinter_18-1.1.2-1PIGSTY.el9.aarch64.rpm
pglinter_18 1.1.2 el10.x86_64 pigsty 601.5 KiB pglinter_18-1.1.2-1PIGSTY.el10.x86_64.rpm
pglinter_18 1.1.2 el10.aarch64 pigsty 476.6 KiB pglinter_18-1.1.2-1PIGSTY.el10.aarch64.rpm
postgresql-18-pglinter 1.1.2 d12.x86_64 pigsty 496.2 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~bookworm_amd64.deb
postgresql-18-pglinter 1.1.2 d12.aarch64 pigsty 364.7 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~bookworm_arm64.deb
postgresql-18-pglinter 1.1.2 d13.x86_64 pigsty 496.2 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~trixie_amd64.deb
postgresql-18-pglinter 1.1.2 d13.aarch64 pigsty 364.5 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~trixie_arm64.deb
postgresql-18-pglinter 1.1.2 u22.x86_64 pigsty 549.8 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~jammy_amd64.deb
postgresql-18-pglinter 1.1.2 u22.aarch64 pigsty 424.9 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~jammy_arm64.deb
postgresql-18-pglinter 1.1.2 u24.x86_64 pigsty 545.0 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~noble_amd64.deb
postgresql-18-pglinter 1.1.2 u24.aarch64 pigsty 418.6 KiB postgresql-18-pglinter_1.1.2-1PIGSTY~noble_arm64.deb

Source

pig build pkg pglinter;		# build rpm/deb

Install

Make sure PGDG and PIGSTY repo available:

pig repo add pgsql -u   # add both repo and update cache

Install this extension with pig:

pig install pglinter;		# install via package name, for the active PG version

pig install pglinter -v 18;   # install for PG 18
pig install pglinter -v 17;   # install for PG 17
pig install pglinter -v 16;   # install for PG 16
pig install pglinter -v 15;   # install for PG 15
pig install pglinter -v 14;   # install for PG 14

Create this extension with:

CREATE EXTENSION pglinter;

Usage

Sources: README, 1.1.2 release

pglinter analyzes your database for potential issues, performance problems, and best practice violations. It outputs results in SARIF 2.1.0 format.

Run Checks

SELECT pglinter.check();                                -- Run all enabled rules
SELECT pglinter.check_rule('B001');                     -- Run a specific rule
SELECT pglinter.check('/path/to/results.sarif');        -- Save SARIF report to file
SELECT pglinter.check_rule('B001', '/path/to/b001.sarif');

Rule Management

SELECT pglinter.show_rules();                -- Show all rules and their status
SELECT pglinter.explain_rule('B001');        -- Get rule details and suggested fixes
SELECT pglinter.enable_rule('B001');         -- Enable a specific rule
SELECT pglinter.disable_rule('B001');        -- Disable a specific rule
SELECT pglinter.is_rule_enabled('B001');     -- Check if a rule is enabled
SELECT pglinter.enable_all_rules();
SELECT pglinter.disable_all_rules();

Rule Configuration

SELECT pglinter.update_rule_levels('B001', 30, 70);   -- Set warning/error thresholds
SELECT pglinter.get_rule_levels('B001');               -- Get current thresholds
SELECT pglinter.export_rules_to_yaml();                -- Export rules to YAML
SELECT pglinter.import_rules_from_yaml('yaml...');     -- Import rules from YAML

Rule Families

Base (B-series): B001 tables without PK, B002 redundant indexes, B003 missing FK indexes, B004 unused indexes, B005 uppercase names, B006 unused tables, B007 cross-schema FKs, B008 FK type mismatches, B009 shared trigger functions, B010 reserved keywords, B011 multiple owners per schema.

Cluster (C-series): C002 insecure pg_hba.conf entries, C003 MD5 password encryption.

Schema (S-series): S001 no default role grants, S002 env prefixes/suffixes, S003 unsecured public schema, S004 system role ownership, S005 multiple owners per schema.

Release Delta

The 1.1.2 release adds rule B013 for row-by-row processing triggers without a WHERE clause. The README has not yet been updated with that rule, so treat the release note as the authoritative delta from 1.1.1.

Last updated on