PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

ALTER STATISTICS

ALTER STATISTICS — 更改一个扩展统计信息对象的定义

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 }

描述

ALTER STATISTICS 更改一个现有扩展统计信息对象的参数。在 ALTER STATISTICS 命令中未明确设置的任何参数都会保留其原有设置。

你必须拥有该统计信息对象才能使用 ALTER STATISTICS。要更改统计信息对象的模式,你还必须在新模式上拥有 CREATE 特权。要更改拥有者,你必须能够 SET ROLE 到新的拥有角色,并且该角色必须在统计信息对象所在模式上拥有 CREATE 特权(这些限制强制确保更改拥有者不会做任何你通过删除并重建统计信息对象也无法完成的事情。不过,超级用户无论如何都能更改任何统计信息对象的拥有权)。

参数

name

要更改的统计对象的名称(可以用模式限定)。

new_owner

该统计信息对象新拥有者的用户名。

new_name

该统计信息对象的新名称。

new_schema

该统计信息对象的新模式。

new_target

此统计信息对象在后续 ANALYZE 操作中的统计信息收集目标。该目标可以设置在 0 到 10000 的范围内。将其设置为 DEFAULT 可以恢复为使用系统默认统计信息目标(default_statistics_target)(设置为 -1 是获得相同结果的一种过时写法)。有关 PostgreSQL 查询规划器如何使用统计信息的更多信息,请参阅 Section 14.2。

兼容性

SQL 标准中没有 ALTER STATISTICS 命令。

另请参阅

CREATE STATISTICS, DROP STATISTICS