GeometryCollection

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

GeometryCollection 은 1개 이상의 geometry 또는 geography 인스턴스 컬렉션입니다. GeometryCollection은 비어 있을 수 있습니다.

GeometryCollection 인스턴스

허용되는 인스턴스

GeometryCollection 인스턴스를 허용하려면 빈 GeometryCollection 인스턴스이거나 GeometryCollection 인스턴스를 구성하는 모든 인스턴스가 허용된 인스턴스여야 합니다. 다음 예제에서는 허용되는 인스턴스를 보여 줍니다.

DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';  
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  

다음 예제 System.FormatException 에서는 GeometryCollection 인스턴스의 LinesString 인스턴스가 허용되지 않기 때문에 throw합니다.

DECLARE @g geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1), POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  

유효한 인스턴스

GeometryCollection 인스턴스를 구성하는 모든 인스턴스가 유효한 경우 GeometryCollection 인스턴스가 유효합니다. 다음은 유효한 GeometryCollection 인스턴스 3개와 유효하지 않은 인스턴스 1개를 보여 줍니다.

DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';  
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g4 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, 1 -5, -5 5, -5 -1, -1 -1)))';  
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();  

@g4 는 GeometryCollection 인스턴스의 Polygon 인스턴스가 유효하지 않으므로 유효하지 않습니다.

허용되는 인스턴스와 유효한 인스턴스에 대한 자세한 내용은 Point, MultiPoint, LineString, MultiLineString, Polygon 및 MultiPolygon을 참조하세요.

예

다음 예제에서는 geometry``GeometryCollection 인스턴스 및 Point 인스턴스가 들어 있는 SRID 1의 Z 값으로 Polygon 을 인스턴스화합니다.

DECLARE @g geometry;  
SET @g = geometry::STGeomCollFromText('GEOMETRYCOLLECTION(POINT(3 3 1), POLYGON((0 0 2, 1 10 3, 1 0 4, 0 0 2)))', 1);  

참고 항목

공간 데이터(SQL Server)