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]

Namen für Tabellen und/oder Namensräume, die Sonderzeichen und Anführungszeichen enthalten, erfordern möglicherweise eine besondere Behandlung. Anmerkung eines Benutzers: "Für die Bezeichnung von Schemata und Tabellen sollten Sie Escape-Regeln verwenden, um einen doppelt in Anführungszeichen gesetzten String zu erzeugen, und anschließend das erste und letzte Anführungszeichen entfernen. Für Geometriespalten können Sie den Namen unverändert angeben."

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)