st_geometry_dump(
geometry
[, "options" ]
)

In der folgenden Tabelle werden die von der st_geometry_dump-Prozedur zurückgegebenen Ergebnisse beschrieben:

Die st_geometry_dump-Systemprozedur zerlegt eine Geometriehierarchie in eine Ergebnismenge mit einer Zeile für jedes der Objekte in der Hierarchie (einschließlich des Stammobjekts). Jede Geometrie in der Hierarchie kann validiert werden, um festzustellen, ob sie gültig ist und ggf. warum sie ungültig ist.

Einige Funktionen der st_geometry_dump-Systemprozedur können mithilfe von typspezifischen Methoden wie ST_GeometryN oder ST_PointN zugeordnet werden.

Die st_geometry_dump-Systemprozedur kann verwendet werden, um ungültige Geometrien zu korrigieren.

Keine

Keine

• ST_IsValid-Methode für den ST_Geometry-Datentyp
• CREATE SPATIAL REFERENCE SYSTEM-Anweisung
• st_geometry_on_invalid-Option
• STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung

Im folgenden Beispiel wird das Polygon, 'Polygon ((0 0, 3 0, 3 3, 0 3, 0 0))', in seine Komponentengeometrien zerlegt:

SELECT * FROM st_geometry_dump( 'Polygon ((0 0, 3 0, 3 3, 0 3, 0 0))', 'SetGeom=No' );

Das folgende Beispiel zeigt, wie die st_geometry_dump-Systemprozedur verwendet werden kann, um die ungültigen Punkte in einer Geometrie zu finden. In diesem Beispiel enthält die Linienfolge einen Punkt mit Länge 1200. Deshalb werden sowohl der Punkt als auch die Linienfolge in den Ergebnissen als ungültig gemeldet (valid=0).

SET TEMPORARY OPTION st_geometry_on_invalid='Ignore';
CREATE OR REPLACE VARIABLE @geo ST_Geometry;
SET @geo = new ST_LineString( 'LineString(1200 2, 80 10)', 4326 );

SELECT * FROM st_geometry_dump( @geo, 'SetGeom=No' );

Wenn ungültige Daten identifiziert wurden, kann die st_geometry_dump-Systemprozedur mit anderen als räumlichen Methoden verwendet werden, um die ungültigen Elemente zu korrigieren und eine gültige Geometrie zusammenzustellen. Das folgende Beispiel zeigt, wie ein ungültiger Punkt mit Länge 1200 in Länge 120.0 korrigiert werden kann:

SET TEMPORARY OPTION st_geometry_on_invalid='Ignore';
CREATE OR REPLACE VARIABLE @geo ST_Geometry;
SET @geo = new ST_LineString( 'LineString(1200 2, 80 10)', 4326 );

SELECT ST_LineString::ST_LineStringAggr( 
    new ST_Point( IF xmax = 1200 then 120.0 ELSE xmax ENDIF, 
                  ymax, 4326 )  ORDER BY id )
FROM  st_geometry_dump( @geo )
WHERE geom_type='ST_Point';