SQL COMMAND · 索引与统计

ALTER STATISTICS

更改扩展统计对象的定义

ALTER索引与统计引入 10（基线）现存至 20 devel2 次语法变更

动词: ALTER
对象: STATISTICS
分组: 索引与统计
引入版本: 10（基线）
状态: 现存
语法变更次数: 2
手册小节数: 4

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER STATISTICS · 语法 2

ALTER STATISTICS · 语法 3

ALTER STATISTICS · 语法 4

语法概要

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 }

PostgreSQL 18 手册 · 查看完整参考页

描述

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

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 14← 13语法变化

+ ALTER STATISTICS name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }+ ALTER STATISTICS name SET STATISTICS { new_target | DEFAULT }− ALTER STATISTICS name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }− ALTER STATISTICS name SET STATISTICS new_target正文更新
PostgreSQL 13← 12语法变化

+ ALTER STATISTICS name SET STATISTICS new_target正文更新

同组命令

命令	动词	对象	最近变更
INDEXES & STATISTICS索引与统计7 条↑
`REINDEX`	REINDEX	—	143 次
重建索引			现存
`CREATE INDEX`	CREATE	INDEX	143 次
定义一个新索引			现存
`ALTER INDEX`	ALTER	INDEX	132 次
更改索引的定义			现存
`DROP INDEX`	DROP	INDEX	—
移除一个索引			现存
`CREATE STATISTICS`	CREATE	STATISTICS	192 次
定义扩展统计信息			现存
`ALTER STATISTICS`	ALTER	STATISTICS	142 次
更改扩展统计对象的定义			现存
`DROP STATISTICS`	DROP	STATISTICS	—
删除扩展统计对象			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

兼容性

另见

语法演化

相关命令

同组命令