描述

CREATE STATISTICS将创建一个新的扩展统计对象， 追踪指定表、外部表或物化视图的数据。该统计对象将在当前数据库中创建， 被发出该命令的用户所有。

CREATE STATISTICS命令有两种基本形式。 第一种形式允许对被收集的单个表达式的单变量统计信息，提供了类似于表达式索引的好处，而不需要索引维护的开销。 这种形式不允许指定统计类型，因为不同的统计类型引用只针对多元统计。 此命令的第二种形式允许收集多个列和/或表达式的多元统计信息，可选地指定需要包括的统计信息类型。 这种格式也会自动使得列表中包含的任何表达式上的单变量统计信息被收集。

如果给定了模式名（比如，CREATE STATISTICS myschema.mystat ...）， 那么在给定的模式中创建统计对象。否则在当前模式中创建。 统计对象的名称必须与相同模式中的任何其他统计对象不同。

参数

注意

你必须是表的所有者才能创建读取它的统计对象。不过，一旦创建， 统计对象的所有权与基础表无关。

表达式统计信息是对每个表达式的，就像在表达式上创建索引，只是它们避免了索引维护的开销。 表达式统计信息是为统计对象定义中的每个表达式自动构建的。

扩展统计信息目前不被查询规划器用于对表连接进行的选择性估计。这个限制可能会在未来版本的 PostgreSQL中被移除。

示例

用两个功能相关的列创建表t1， 即第一列中的值的信息足以确定另一列中的值。然后， 在这些列上构建函数依赖关系统计信息：

CREATE TABLE t1 (
    a   int,
    b   int
);

INSERT INTO t1 SELECT i/100, i/500
                 FROM generate_series(1,1000000) s(i);

ANALYZE t1;

-- 匹配行的数量将被大大低估：
EXPLAIN ANALYZE SELECT * FROM t1 WHERE (a = 1) AND (b = 0);

CREATE STATISTICS s1 (dependencies) ON a, b FROM t1;

ANALYZE t1;

-- 现在行计数估计会更准确：
EXPLAIN ANALYZE SELECT * FROM t1 WHERE (a = 1) AND (b = 0);

如果没有函数依赖性统计，规划器会认为两个WHERE条件是独立的， 并且会将它们的选择性乘以一起，以致得到太小的行数估计。 通过这样的统计，规划器认识到WHERE条件是多余的，并且不会低估行数。

创建表t2与两个完全相关的列(包含相同的数据)，并且在这些列上创建一个MCV列表:

CREATE TABLE t2 (
    a   int,
    b   int
);

INSERT INTO t2 SELECT mod(i,100), mod(i,100)
                 FROM generate_series(1,1000000) s(i);

CREATE STATISTICS s2 (mcv) ON a, b FROM t2;

ANALYZE t2;

-- valid combination (found in MCV)
EXPLAIN ANALYZE SELECT * FROM t2 WHERE (a = 1) AND (b = 1);

-- invalid combination (not found in MCV)
EXPLAIN ANALYZE SELECT * FROM t2 WHERE (a = 1) AND (b = 2);

MCV列表为计划器提供了关于表中普遍出现的特定值的更详细的信息，以及表中未显示的值组合的选择性上限，允许它在这两种情况下产生更好的估计值。

使用单个时间戳列创建表t3，并用该列上的表达式运行查询。 没有扩展的统计信息，计划器无法获知表达式数据分布的相关信息，然后使用默认的估计值。 计划器也没有认识到按月截断日期的值完全取决于按天截断日期的值。 然后表达式和模糊统计构建在这两个表达式之上:

CREATE TABLE t3 (
    a   timestamp
);

INSERT INTO t3 SELECT i FROM generate_series('2020-01-01'::timestamp,
                                             '2020-12-31'::timestamp,
                                             '1 minute'::interval) s(i);

ANALYZE t3;

-- the number of matching rows will be drastically underestimated:
EXPLAIN ANALYZE SELECT * FROM t3
  WHERE date_trunc('month', a) = '2020-01-01'::timestamp;

EXPLAIN ANALYZE SELECT * FROM t3
  WHERE date_trunc('day', a) BETWEEN '2020-01-01'::timestamp
                                 AND '2020-06-30'::timestamp;

EXPLAIN ANALYZE SELECT date_trunc('month', a), date_trunc('day', a)
   FROM t3 GROUP BY 1, 2;

-- build ndistinct statistics on the pair of expressions (per-expression
-- statistics are built automatically)
CREATE STATISTICS s3 (ndistinct) ON date_trunc('month', a), date_trunc('day', a) FROM t3;

ANALYZE t3;

-- now the row count estimates are more accurate:
EXPLAIN ANALYZE SELECT * FROM t3
  WHERE date_trunc('month', a) = '2020-01-01'::timestamp;

EXPLAIN ANALYZE SELECT * FROM t3
  WHERE date_trunc('day', a) BETWEEN '2020-01-01'::timestamp
                                 AND '2020-06-30'::timestamp;

EXPLAIN ANALYZE SELECT date_trunc('month', a), date_trunc('day', a)
   FROM t3 GROUP BY 1, 2;

没有表达式和模糊统计信息，规划器就没有表达式的不同值的数量所相关的信息，并且不得不依赖默认估计值。 相等和范围条件假设有0.5%的选择度，并且表达式中不同值的数量被假设为与列相同(也就是独一无二的)。 这将导致前两个查询中的行数严重低估。 此外，计划器没有关于表达式之间关系的信息，所以它假设两个WHERE和GROUP BY条件是独立的，并将它们的选择相乘，以得到对聚合查询中的组数的严重高估。 由于缺乏表达式准确的统计信息，这种情况进一步加剧了，强迫计划器使用默认的ndistinct估计，对于从列的ndistinct派生的表达式。 有了这些统计信息，规划器就能认识到这些条件是有相互关系的，并得出更准确的估计。

兼容性

SQL标准中没有CREATE STATISTICS命令。

又见