名稱

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_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]

對於包含特殊字元和引號的表格和/或命名空間的名稱,可能需要特殊處理。使用者指出:「對於綱要和表格,請使用識別符號跳脫規則來產生雙引號字串,然後移除第一個和最後一個雙引號字元。對於幾何欄位,則按原樣傳遞。」

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