Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ALTER STATISTICS(7)	 PostgreSQL 17.5 Documentation	   ALTER STATISTICS(7)

NAME
       ALTER_STATISTICS	- change the definition	of an extended statistics
       object

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. Any parameters not specifically set in the ALTER
       STATISTICS command retain their prior settings.

       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.

       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.

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

SEE ALSO
       CREATE STATISTICS (CREATE_STATISTICS(7)), DROP STATISTICS
       (DROP_STATISTICS(7))

PostgreSQL 17.5			     2025		   ALTER STATISTICS(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ALTER_STATISTICS&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help