ST_GeomCollection::ST_GeomCollectionAggr(geometry-column[ ORDER BY order-by-expression [ ASC | DESC ], ... ] )

ST_GeomCollectionAggr 集合関数を使用して、ジオメトリのグループを 1 つのコレクションに結合することができます。結合するすべてのジオメトリの SRID と座標次元の両方が同じになるようにします。

引数が NULL のローは含まれません。

空のグループ、または NULL 以外の値が含まれないグループの場合、NULL を返します。

結果の ST_GeomCollection の座標次元は、各ジオメトリの座標次元と同じになります。

ST_GeometryN から目的の順序で要素が返されるように、オプションの ORDER BY 句を使用して要素を特定の順序に並べ替えることができます。この順序が意味を持たない場合は、順序を指定しない方が効率的です。その場合、要素の順序は、クエリオプティマイザが選択したアクセスプランにより決定されます。

ST_GeomCollectionAggr は ST_UnionAggr より効率的ですが、ジオメトリのグループの中に重複するジオメトリが存在する場合には、そのような重複を伴ったコレクションを返す可能性があります。特に、返されたコレクションに重複する面が含まれている場合に、それが他の空間メソッドの入力値として使用されると、予期しない結果をもたらす場合があります。ST_UnionAggr では、重複するジオメトリを処理できます。

• ST_Geometry タイプの ST_UnionAggr メソッド

次の例では、SpatialShapes テーブルのすべてのジオメトリを 1 つのコレクションに結合した単一の値を返します。

SELECT ST_GeomCollection::ST_GeomCollectionAggr( Shape ) FROM SpatialShapes
	WHERE Shape.ST_Is3D() = 0