Beschreibung

Sammelt Geometrien in einer Geometriesammlung. Das Ergebnis ist entweder ein Multi* oder eine GeometryCollection, je nachdem, ob die Eingabegeometrien denselben oder einen unterschiedlichen Typ haben (homogen oder heterogen). Die Eingangsgeometrien bleiben in der Sammlung unverändert.

Variante 1: akzeptiert zwei Eingabegeometrien

Variante 2: akzeptiert eine Reihe von Geometrien

Variante 3: Aggregatfunktion, die ein Rowset von Geometrien akzeptiert.

	ST_Collect does not dissolve boundaries or resolve overlaps. Collecting overlapping polygons can produce an invalid MultiPolygon. If the result must be a valid polygonal geometry with overlaps merged, use ST_Union instead. ST_Union also splits linestrings at intersections and may return a single geometry after dissolving boundaries.

If any input geometry is a collection (Multi* or GeometryCollection), ST_Collect returns a GeometryCollection, since that is the only type which can contain nested collections. To prevent this, use ST_Dump in a subquery to expand input collections to their atomic elements (see example below).

Verfügbarkeit: 1.4.0 - ST_MakeLine(geomarray) wurde eingeführt. ST_MakeLine Aggregatfunktion wurde verbessert, um mehr Punkte schneller handhaben zu können.

Diese Funktion unterstützt 3d und lässt den Z-Index nicht fallen.

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

Beispiele

Two-input variant.

Sammeln Sie 2D-Punkte.

SELECT ST_Collect(
    'POINT(1 2)',
    'POINT(-2 3)' );

MULTIPOINT((1 2),(-2 3))

0104000000020000000101000000000000000000F03F0000000000000040010100000000000000000000C00000000000000840

Figure

Sammeln Sie 3D-Punkte.

SELECT ST_Collect(
        'POINT(1 2 3)',
        'POINT(1 2 4)' );

MULTIPOINT(1 2 3,1 2 4)

0104000080020000000101000080000000000000F03F000000000000004000000000000008400101000080000000000000F03F00000000000000400000000000001040

Figure

Kurven sammeln.

SELECT ST_Collect(
        'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
        'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)');

MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))

010B000000020000000108000000030000000000000060E30A4100000000785C02410000000018E20A4100000000485F02410000000018E20A4100000000305C02410108000000030000000000000018E20A4100000000305C02410000008061F0404100000000385C02410000000018E20A4100000000305C0241

Figure

Array variant.

Verwendung eines Array-Konstruktors für eine Subquery.

SELECT ST_Collect(ARRAY(SELECT geom FROM sometable));

Verwendung eines Array-Konstruktors für Werte.

SELECT ST_Collect(
        ARRAY[ 'LINESTRING(1 2,3 4)'::geometry,
            'LINESTRING(3 4,4 5)'::geometry ] ) As wktcollect;

MULTILINESTRING((1 2,3 4),(3 4,4 5))

010500000002000000010200000002000000000000000000F03F0000000000000040000000000000084000000000000010400102000000020000000000000000000840000000000000104000000000000010400000000000001440

Figure

Aggregate variant.

Erstellen mehrerer Sammlungen durch Gruppierung von Geometrien in einer Tabelle.

SELECT stusps, ST_Collect(geom) AS geom
FROM (
  SELECT stusps, (ST_Dump(geom)).geom AS geom
  FROM somestatetable
) AS f
GROUP BY stusps;

Siehe auch

ST_Dump, ST_AsBinary