Schemas & Extensions

Mon, 01 Jan 0001 00:00:00 +0000

SCHEMA

Schemas have no ( ) list. Their { } block holds attributes and nested objects directly.

Empty schema

SCHEMA public { }

-- emits
CREATE SCHEMA IF NOT EXISTS "public";

Schema with owner and comment

SCHEMA analytics {
 OWNER analytics_role;
 COMMENT 'Derived tables and event aggregations';
}

-- emits
CREATE SCHEMA IF NOT EXISTS "analytics";
ALTER SCHEMA "analytics" OWNER TO "analytics_role";
COMMENT ON SCHEMA "analytics" IS 'Derived tables and event aggregations';

Schema with grants

SCHEMA analytics {
 GRANTS {
 USAGE TO app_readonly;
 ALL TO analytics_admin;
 }
}

-- emits
CREATE SCHEMA IF NOT EXISTS "analytics";
GRANT USAGE ON SCHEMA "analytics" TO "app_readonly";
GRANT ALL ON SCHEMA "analytics" TO "analytics_admin";

Schema rename

SCHEMA reporting {
 RENAMED FROM old_reporting;
}

-- emits
ALTER SCHEMA "old_reporting" RENAME TO "reporting";

See Lifecycle Directives for RENAMED FROM behaviour across schema, table, and column renames.

Sequences

Mon, 01 Jan 0001 00:00:00 +0000

Sequences are schema-level objects. Do not declare sequences that back GENERATED AS IDENTITY or SERIAL columns — PostgreSQL manages those automatically.

Basic sequence

SCHEMA public {
 SEQUENCE order_number_seq;
}

-- emits
CREATE SEQUENCE "public"."order_number_seq";

Sequence with all options

SCHEMA public {
 SEQUENCE order_number_seq
 AS BIGINT
 START WITH 10000
 INCREMENT BY 1
 MINVALUE 10000
 MAXVALUE 99999999
 CACHE 50
 NO CYCLE
 OWNED BY orders.order_number;
}

-- emits
CREATE SEQUENCE "public"."order_number_seq"
 AS bigint
 START WITH 10000
 INCREMENT BY 1
 MINVALUE 10000
 MAXVALUE 99999999
 CACHE 50
 NO CYCLE
 OWNED BY "public"."orders"."order_number";

Altering sequence options

Changing any option emits ALTER SEQUENCE:

Schema Objects on DPG — Declarative PG