ALTER_SCHEMA(7pg13)

okay bestie, this is the ALTER_SCHEMA(7) page from the PostgreSQL 13.23 Documentation 💅 it’s short, it’s iconic, and we’re getting into it.

💖 NAME 💖

• ALTER_SCHEMA — change the definition of a schema. slay.

✨ SYNOPSIS ✨

ALTER SCHEMA name RENAME TO new_name
ALTER SCHEMA name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }

🦋 DESCRIPTION 🦋

ALTER SCHEMA changes the definition of a schema. literally its whole job.

You must own the schema to use ALTER SCHEMA. To rename a schema you must also have the CREATE privilege for the database. To alter the owner, you must also be a direct or indirect member of the new owning role, and you must have the CREATE privilege for the database. (Note that superusers have all these privileges automatically.) 👑

🎀 PARAMETERS 🎀

• name — the name of an existing schema. bless.
• new_name — the new name of the schema. hard rule bestie: the new name cannot begin with pg_, as such names are reserved for system schemas. 🚫
• new_owner — the new owner of the schema. hand over the crown. 👑

🌈 COMPATIBILITY 🌈

There is no ALTER SCHEMA statement in the SQL standard. not a single one. wild. 💀

👑 SEE ALSO 👑

• CREATE SCHEMA (CREATE_SCHEMA(7))
• DROP SCHEMA (DROP_SCHEMA(7))

💖 that’s the whole vibe — brought to you by PostgreSQL 13.23, dated 2025. periodt. 🫶