ST_EstimatedExtent
上一个 7.18. 边界框函数 下一个

名称

ST_EstimatedExtent — 返回空间表的估计范围。

语法

box2d ST_EstimatedExtent(text schema_name, text table_name, text geocolumn_name, boolean parent_only);

box2d ST_EstimatedExtent(text schema_name, text table_name, text geocolumn_name);

box2d ST_EstimatedExtent(text table_name, text geocolumn_name);

描述

以 box2d 的形式返回空间表的估计范围。如果没有指定，则使用当前架构。估计范围取自几何列的统计信息。这通常比使用 ST_Extent 或 ST_3DExtent 计算表的精确范围快得多。

默认行为是还使用从子表（具有 INHERITS 的表）收集的统计信息（如果可用）。如果将 parent_only 设置为 TRUE，则仅使用给定表的统计信息，而忽略子表。

对于 PostgreSQL >= 8.0.0，统计信息由 VACUUM ANALYZE 收集，结果范围将约为实际范围的 95%。对于 PostgreSQL < 8.0.0，统计信息通过运行 update_geometry_stats() 收集，结果范围是准确的。

[Note]

在没有统计信息（空表或未调用 ANALYZE）的情况下，此函数返回 NULL。在 1.5.4 版本之前，会引发异常。

可用性：1.0.0

已更改：2.1.0。在 2.0.x 之前，此函数称为 ST_Estimated_Extent。

此方法支持圆形字符串和曲线。

示例

SELECT ST_EstimatedExtent('ny', 'edges', 'geom');
--result--
BOX(-8877653 4912316,-8010225.5 5589284)

SELECT ST_EstimatedExtent('feature_poly', 'geom');
--result--
BOX(-124.659652709961 24.6830825805664,-67.7798080444336 49.0012092590332)

另请参见

ST_Extent、ST_3DExtent

上一个 向上 下一个
Box3D 主页 ST_Expand