ST_ToMultiPolygon-Methode

Konvertiert die Geometrie in einen Multipolygonwert.

Syntax

geometry-expression.ST_ToMultiPolygon()

Rückgabe

ST_MultiPolygon Wenn geometry-expression vom Typ ST_MultiPolygon ist, wird geometry-expression zurückgegeben. Wenn geometry-expression eine Geometriegruppe mit nur Polygonen ist, wird ein Multipolygonobjekt zurückgegeben, das die Elemente von geometry-expression enthält. Wenn geometry-expression vom Typ ST_Polygon ist, wird ein Multipolygonausdruck zurückgegeben, der ein Element enthält, nämlich geometry-expression. Wenn geometry-expression die leere Menge ist, wird eine leere Menge vom Typ ST_MultiSurface zurückgegeben. Andernfalls wird eine Ausnahmebedingung generiert.
Der Bezeichner des räumlichen Bezugssystems für das Ergebnis ist der gleiche wie beim räumlichen Bezugssystem von geometry-expression.

Wenn geometry-expression bereits als ST_MultiPolygon-Wert bekannt ist, sollte für höhere Effizienz TREAT( geometry-expression AS ST_MultiPolygon ) und nicht die ST_ToMultiPolygon-Methode verwendet werden.

Hinweis

Standardmäßig verwendet ST_ToMultiPolygon das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

Siehe auch

Standards und Kompatibilität

Beispiel

Das folgende Beispiel gibt den Wert MultiPolygon EMPTY zurück.

SELECT NEW ST_GeomCollection().ST_ToMultiPolygon()

Der folgende Code gibt einen Fehler zurück, weil die Shape-Spalte vom Typ ST_Geometry ist und ST_Geometry die ST_Area-Methode nicht unterstützt.

SELECT Shape.ST_Area()
FROM SpatialShapes WHERE ShapeID = 27

Der folgende Code verwendet ST_ToMultiPolygon, um den Typ des Shape-Spaltenausdrucks auf ST_ToMultiPolygon zu ändern. Dieses Beispiel funktioniert auch mit ShapeID 22, wobei der Shape-Wert vom Typ ST_LineString ist. ST_Area gibt das Ergebnis 8 zurück.

SELECT Shape.ST_ToMultiPolygon().ST_Area()
FROM SpatialShapes WHERE ShapeID = 27

In diesem Fall ist der Wert der Shape-Spalte als ST_MultiPolygon-Typ bekannt, daher kann TREAT verwendet werden, um den Ausdruckstyp effizient zu ändern. Dieses Beispiel würde mit ShapeID 22 nicht funktionieren, wo der Shape-Wert vom Typ ST_Polygon ist. ST_Area gibt das Ergebnis 8 zurück.

SELECT TREAT( Shape AS ST_MultiPolygon ).ST_Area() 
FROM SpatialShapes WHERE ShapeID = 27

Kommentieren Sie diese Seite in DocCommentXchange.