SYSTEM CATALOG · System catalog

pg_rewrite

PostgreSQL documentation ↗Source definition ↗

The catalog pg_rewrite stores rewrite rules for tables and views.

First seen PG 9.0Last seen PG 19Columns 8

9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19^β3

Checked column by column against a PostgreSQL 18.6 instance · Raw measurement record ↗

Columns PostgreSQL 18

pg_rewrite

COLUMN	TYPE	DESCRIPTION
`oid`	`oid`NOT NULL	Row identifier
`rulename`	`name`NOT NULL	Rule name
`ev_class`	`oid`NOT NULL	The table this rule is forReferences:`pg_class.oid`
`ev_type`	`"char"`NOT NULLDocumented as:`char`	Event type that the rule is for: 1 = SELECT, 2 = UPDATE, 3 = INSERT, 4 = DELETE
`ev_enabled`	`"char"`NOT NULLDocumented as:`char`	Controls in which session_replication_role modes the rule fires. O = rule fires in “origin” and “local” modes, D = rule is disabled, R = rule fires in “replica” mode, A = rule fires always.
`is_instead`	`boolean`NOT NULLDocumented as:`bool`	True if the rule is an INSTEAD rule
`ev_qual`	`pg_node_tree`NOT NULL	Expression tree (in the form of a nodeToString() representation) for the rule's qualifying condition
`ev_action`	`pg_node_tree`NOT NULL	Query tree (in the form of a nodeToString() representation) for the rule's action

Columns marked "implicit" are not included in SELECT *; some early statistics views are completed from same-version source, and the extra provenance is shown in the column description.

Common system columns 6

System attributes PostgreSQL provides, normally not expanded by SELECT *. Kept separately so they are not mixed in with ordinary columns.

Columns	Type	attnum
`tableoid`	`oid`	-6
`cmax`	`cid`	-5
`xmax`	`xid`	-4
`cmin`	`cid`	-3
`xmin`	`xid`	-2
`ctid`	`tid`	-1

Column evolution matrix

Hover a cell for the column type

PresentAdded / type or attribute changeRemoved

COLUMN	9.4	9.5	9.6	10	11	12	13	14	15	16	17	18	19
`oid`
`rulename`
`ev_class`
`ev_attr`	−	–	–	–	–	–	–	–	–	–	–	–	–
`ev_type`
`ev_enabled`
`is_instead`
`ev_qual`
`ev_action`

9.0 is the coverage baseline; a column already present in the baseline is not marked as added. The matrix aligns columns by name, so a rename appears as the old column removed and a new column added.

Evolution timeline

Changes between adjacent majors

PostgreSQL 12 ← 11

~ ev_action: not_null: false → true~ ev_qual: not_null: false → true~ oid: implicit → ordinary1 column description updates

PostgreSQL 10 ← 9.6

1 column description updates

PostgreSQL 9.4 ← 9.3

− ev_attr

PostgreSQL 9.3 ← 9.2

1 column description updates

PostgreSQL 9.1 ← 9.0

~ ev_action: text → pg_node_tree~ ev_qual: text → pg_node_tree

Compare any two versions

FROMTOInclude description updates

Pick two versions to see added, removed, and retyped columns. The interactive comparison needs JavaScript; the evolution timeline reads fine without it.