ST_EstimatedExtent
Prev  7.18. Bounding Box-Funktionen  Next

Name

ST_EstimatedExtent — Gibt die geschätzte Ausdehnung einer räumlichen Tabelle zurück.

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

Beschreibung

Gibt die geschätzte Ausdehnung einer räumlichen Tabelle als box2d zurück. Falls nicht angegeben, wird das aktuelle Schema verwendet. Die geschätzte Ausdehnung wird aus den Statistiken der Geometriespalte entnommen. Dies ist in der Regel viel schneller als die Berechnung der genauen Ausdehnung der Tabelle mit ST_Extent oder ST_3DExtent.

Standardmäßig werden auch Statistiken aus Kindtabellen (Tabellen mit INHERITS) verwendet, sofern diese verfügbar sind. Wenn parent_only auf TRUE gesetzt ist, werden nur Statistiken für die angegebene Tabelle verwendet und untergeordnete Tabellen ignoriert.

Für PostgreSQL >= 8.0.0 werden die Statistiken durch VACUUM ANALYZE erfasst, und der Ergebnisumfang entspricht etwa 95% des tatsächlichen Umfangs. Für PostgreSQL < 8.0.0 werden die Statistiken durch Ausführen von update_geometry_stats() erfasst und der Ergebnisumfang ist exakt.

[Note]

Wenn keine Statistiken vorhanden sind (leere Tabelle oder kein ANALYZE-Aufruf), gibt diese Funktion NULL zurück. Vor Version 1.5.4 wurde stattdessen eine Ausnahme ausgelöst.

[Note]

Escaping names for tables and/or namespaces that include special characters and quotes may require special handling. A user notes: "For schemas and tables, use identifier escaping rules to produce a double-quoted string, and afterwards remove the first and last double-quote character. For geometry column pass as is."

Verfügbarkeit: 1.0.0

Geändert: 2.1.0. Bis zu 2.0.x hieß dies ST_Estimated_Extent.

Diese Methode unterstützt kreisförmige Strings und Kurven.

Beispiele

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)