ALTER_CONVERSION(7pg17)

💅 ALTER_CONVERSION — change the definition of a conversion

okay so bestie, welcome to the ALTER CONVERSION page from the PostgreSQL 17.11 Documentation ✨ this one's short and sweet and honestly a little underrated. let's get into it 🫶

---

🌸 SYNOPSIS 🌸

ALTER CONVERSION name RENAME TO new_name
ALTER CONVERSION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER CONVERSION name SET SCHEMA new_schema

three whole moods. pick one. slay 💅

---

✨ DESCRIPTION ✨

ALTER CONVERSION changes the definition of a conversion. that's it, that's the whole vibe. iconic minimalism honestly 🎀

but here's the thing — you must own the conversion to use ALTER CONVERSION. no ownership, no edits, periodt.

and if you wanna alter the owner? okay diva, extra steps unlocked 🔓 — you must be able to SET ROLE to the new owning role, and that role must have CREATE privilege on the conversion's schema. why, you ask? because these restrictions enforce that altering the owner doesn't do anything you couldn't do by dropping and recreating the conversion. like, no sneaky loopholes fr fr 🦋

💀 tiny caveat bestie: a superuser can alter ownership of any conversion anyway. main character energy, no rules apply 😭

---

🦋 PARAMETERS 🦋

• name — the name of an existing conversion (optionally schema-qualified, bc we love options ✨)
• new_name — the new name of the conversion. glow-up name 💖
• new_owner — the new owner of the conversion. new boss, same conversion 👑
• new_schema — the new schema for the conversion. moving houses 🏠

---

🌈 EXAMPLES 🌈

okay so you want to rename the conversion iso_8859_1_to_utf8 to latin1_to_unicode? say less:

ALTER CONVERSION iso_8859_1_to_utf8 RENAME TO latin1_to_unicode;

and if you wanna change the owner of the conversion iso_8859_1_to_utf8 to joe (hi joe 👋), you do:

ALTER CONVERSION iso_8859_1_to_utf8 OWNER TO joe;

ate. no notes. 🍓

---

🧚 COMPATIBILITY 🧚

there is no ALTER CONVERSION statement in the SQL standard. like… at all. not a thing. PostgreSQL said "we'll do it ourselves" and honestly? valid 💅

---

⭐ SEE ALSO ⭐

• CREATE CONVERSION (CREATE_CONVERSION(7)) — making conversions happen ✨
• DROP CONVERSION (DROP_CONVERSION(7)) — bye bye conversion 🦋

---

and that's the whole page bestie!! 💜 this little beauty came from the PostgreSQL 17.11 Documentation, dated 2026, and it's giving "short manpage, big personality". mwah 🎀💖🫶