↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

ALTER STATISTICS

更改扩展统计对象的定义

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

1011121314151617181920
anchor
SQL-ALTERSTATISTICS
file
sql-alterstatistics.html
lang
en
name
ALTER STATISTICS
purpose
change the definition of an extended statistics object
purpose zh
未知
sections same as
未知
slug
18
synopsis text
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 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 name OWNER TO new_owner CURRENT_ROLE CURRENT_USER SESSION_USER
ALTER STATISTICS · 语法 2
ALTER STATISTICS name RENAME TO new_name
ALTER STATISTICS · 语法 3
ALTER STATISTICS name SET SCHEMA new_schema
ALTER STATISTICS · 语法 4
ALTER STATISTICS name SET STATISTICS new_target DEFAULT

版本定义 PG 18

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查询规划器如何使用统计信息的更多内容，请参见第 14.2 节。

兼容性

SQL 标准中没有ALTER STATISTICS命令。

另见

CREATE STATISTICS, DROP STATISTICS

比较版本

完整来源事实

synopsis html

ALTER STATISTICS <em class="replaceable"><code>name</code></em> OWNER TO { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER STATISTICS <em class="replaceable"><code>name</code></em> RENAME TO <em class="replaceable"><code>new_name</code></em>
ALTER STATISTICS <em class="replaceable"><code>name</code></em> SET SCHEMA <em class="replaceable"><code>new_schema</code></em>
ALTER STATISTICS <em class="replaceable"><code>name</code></em> SET STATISTICS { <em class="replaceable"><code>new_target</code></em> | DEFAULT }

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c