ALTER_STATISTICS(7pg17)

💖 NAME 💖

okay so bestie, welcome to the ALTER STATISTICS page from the PostgreSQL 17.11 Documentation ✨ this is the one that changes the definition of an extended statistics object. yes, that kind of glow-up for your stats 💅

---

🦋 SYNOPSIS 🦋

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

---

🌸 DESCRIPTION 🌸

ALTER STATISTICS changes the parameters of an existing extended statistics object. literally any parameters you don’t specifically set in the ALTER STATISTICS command just keep their prior settings — no cap 🫶

You must own the statistics object to use ALTER STATISTICS. To change a statistics object’s schema, you must also have CREATE privilege on the new schema. To alter the owner, you must be able to SET ROLE to the new owning role, and that role must have CREATE privilege on the statistics object’s schema. (These restrictions enforce that altering the owner doesn’t do anything you couldn’t do by dropping and recreating the statistics object. However, a superuser can alter ownership of any statistics object anyway.) 👑

---

🎀 PARAMETERS 🎀

• name — the name (optionally schema-qualified) of the statistics object to be altered. iykyk, it’s the target of your makeover 💫
• new_owner — the user name of the new owner of the statistics object.
• new_name — the new name for the statistics object.
• new_schema — the new schema for the statistics object.
• new_target — the statistic-gathering target for this statistics object for subsequent ANALYZE operations. The target can be set in the range 0 to 10000. Set it to DEFAULT to revert to using the system default statistics target (default_statistics_target). (Setting to a value of -1 is an obsolete way spelling to get the same outcome.) For more information on the use of statistics by the PostgreSQL query planner, refer to Section 14.2. 🔥

bestie warning-ish note: -1 still gets you the same outcome, but it’s the obsolete spelling — the more you know 💀

---

🌈 COMPATIBILITY 🌈

There is no ALTER STATISTICS command in the SQL standard. periodt.

---

⭐ SEE ALSO ⭐

• CREATE STATISTICS (CREATE_STATISTICS(7))
• DROP STATISTICS (DROP_STATISTICS(7))

---

and that’s the whole vibe 💜 this icon was brought to you by PostgreSQL 17.11, dated 2026, and the manual page ALTER STATISTICS(7) — mwah, slay 🎀✨