Name

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

Synopsis

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);

描述

将空间表的估计范围作为 框2d 。如果未指定,则使用当前架构。估计的范围取自几何列的统计数据。这通常比使用以下命令计算表的确切范围快得多 ST_ExtentST_3DExtent

默认行为是还使用从子表(带有继承的表)收集的统计信息(如果可用)。如果 parent_only 设置为True,则只使用给定表的统计信息,而忽略子表。

对于PostgreSQL > =8.0.0通过真空分析收集统计数据,结果程度约为实际的95%。对于PostgreSQL < 8.0.0通过运行以下命令收集统计信息 update_geometry_stats() 且结果范围准确。

[Note]

如果没有统计数据(空表或未调用分析),则此函数返回NULL。在1.5.4版之前,抛出了一个异常。

可用性:1.0.0

更改:2.1.0。直到2.0.x版本,这被称为ST_ESTIMATED_EXTEND。

This method supports Circular Strings and Curves

示例

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