NAME

       ANALYZE - 收集与数据库有关的统计

SYNOPSIS

       ANALYZE [ VERBOSE ] [ table [ (column [, ...] ) ] ]

DESCRIPTION 描述

       ANALYZE  收集有关  PostgreSQL  表的内容的统计，然后把结果保存在系统表 pg_statistic  里。随
       后，查询规划器就可以使用这些统计帮助判断查询的最有效的规划。

        如果没有参数，ANALYZE 检查在当前数据库里的所有表。 如果有参数，ANALYZE 只检查那个表。  你
       还可以给出一列字段名字，这个时候只收集那些字段的统计信息。

PARAMETERS 参数

       VERBOSE
               打开处理过程信息的显示。

       table
               要分析的特定表（可能用模式名修饰）的名字。缺省是当前数据库里所有表。

       column
               要分析的特定字段的名字。缺省是所有字段。

OUTPUTS 输出

        如果声明了 VERBOSE，ANALYZE 发出进度信息，表明当前正在处理的是哪行。 同时打印有关改表的很
       多其它信息。

NOTES 注意

        周期性地运行 ANALYZE，或者在对表的大部分内容做了更改之后马上运行它是个好习惯， 准确的统计
       信息将帮助规划器选择最合适的查询规划，并因此而改善查询处理的速度。  一种比较经常采用的策略
       是每天在低负荷的时候运行一次 VACUUM [vacuum(7)] 和 ANALYZE。

        和 VACUUM FULL 不同的是， ANALYZE 只需要在目标表上有一个读取锁， 因此它可以和表上的其它活
       动并行地运行。

        收集的统计信息通常包括一个每字段最常用数值的列表以及一个包线图，显示每个字段里数据的近似
       分布。  如果  ANALYZE  认为它们都没有什么用，   （比如，在一个唯一键字的字段上没有公共的数
       值）或者是该字段数据类型不支持相关的操作符，  那么它们都可以忽略。在  Chapter 21 ``Routine
       Database Maintenance'' 中有关于统计的更多信息。

        对于大表，ANALYZE 采集表内容的一个随机的抽样做统计，而不是检查每一行。 这样就保证了即使是
       在很大的表上，我们也只需要很少的一些时间就可以完成分析。  不过，要注意的是统计只是近似的结
       果，而且每次运行ANALYZE都会导致 EXPLAIN 显示的规划器的预期开销有一些小变化，  即使表内容实
       际上没有改变也这样。在很小的概率的情况下，这个不确定的行为会导致查询优化器在不同   ANALYZE
       之间选择不同的查询规划。为了避免这个问题，可以提高 ANALYZE  收集的统计数量，像下面描述的那
       样。

        分析的广度可以通过用调整  default_statistics_target  参变量，  或者是以每字段为基础通过用
       ALTER TABLE ... ALTER COLUMN ... SET STATISTICS  （参阅  ALTER TABLE [alter_table(7)]） 设
       置每字段的统计目标来控制。目标数值设置最常用数值列表中的记录的最大数目以及包线图中的最大块
       数。 缺省的目标数值是 10，不过我们可以调节这个数值获取规划器计算精度和 ANALYZE  运行所需要
       的时间以及  pg_statistic 里面占据的空间数目之间的平衡。 特别是，把统计目标设置为零就关闭了
       该字段的统计收集。 这么做对那些从来不参与到查询的 WHERE，GROUP BY，或者 ORDER BY  子句里的
       字段是很有用的，因为规划器不会使用到这样的字段上的统计。

        在被分析的字段中最大的统计目标决定为统计采样的表中的行的数目。  增大目标会导致做  ANALYZE
       的时候成比例地增大对时间和空间的需求。

COMPATIBILITY 兼容性

       SQL 标准里没有 ANALYZE 语句。

译者

       Postgresql 中文网站 何伟平 <laser@pgsqldb.org>