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

描述

box2d 形式返回空间表的估计范围。 如果未指定,则使用当前架构。 估计范围取自几何列的统计数据。 这通常比使用 ST_ExtentST_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 版本之前,会抛出异常。

[Note]

对于表名或命名空间(schema)的名称,如果包含特殊字符或引号,可能需要进行特殊处理。有些用户会使用“标识符转义规则”,“通过加上双引号来生成字符串,然后去掉最前面和最后面的双引号。而对于几何列(geometry column),则直接传递原始值,而不进行任何额外的处理。”

可用性: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