LineString

아티클
07/12/2024

적용 대상: SQL Server Azure SQL 데이터베이스 SQL Managed Instance

LineString 은 일련의 점과 이 점을 연결하는 선분을 나타내는 1차원 개체입니다.

LineString 인스턴스

아래 일러스트레이션은 LineString 인스턴스의 예제를 보여줍니다.

기하학 LineString 인스턴스의 예

그림에 대한 설명:

그림 1은 단순하고 닫혀 있지 않은 LineString 인스턴스입니다.
그림 2는 단순하지 않고 닫혀 있지 않은 LineString 인스턴스입니다.
그림 3은 닫혀 있고 단순한 LineString 인스턴스이므로 링입니다.
그림 4는 닫혀 있고 단순하지 않은 LineString 인스턴스이므로 링이 아닙니다.

허용되는 인스턴스

허용되는 LineString 인스턴스는 기하 도형 변수에 입력될 수 있지만 유효한 LineString 인스턴스가 아닐 수 있습니다. LineString 인스턴스를 허용하려면 다음 조건을 충족해야 합니다. 인스턴스는 2개 이상의 점으로 구성되어야 하거나 비어 있어야 합니다. 다음 LineString 인스턴스는 허용됩니다.

DECLARE @g1 geometry = 'LINESTRING EMPTY';  
DECLARE @g2 geometry = 'LINESTRING(1 1,2 3,4 8, -6 3)';  
DECLARE @g3 geometry = 'LINESTRING(1 1, 1 1)';

@g3은(는) LineString 인스턴스를 허용할 수 있지만 유효하지 않음을 보여 줍니다.

다음 LineString 인스턴스는 허용되지 않습니다. 이 인스턴스에서 System.FormatException이 발생합니다.

DECLARE @g geometry = 'LINESTRING(1 1)';

유효한 인스턴스

LineString 인스턴스는 다음 조건을 충족해야 유효합니다.

LineString 인스턴스를 허용해야 합니다.
LineString 인스턴스가 비어 있지 않는 경우 해당 인스턴스에 고유 포인트가 2개 이상 포함되어야 합니다.
LineString 인스턴스는 두 개 이상의 연속 포인트 간격으로 자체적으로 겹쳐질 수 없습니다.

다음 LineString 인스턴스는 유효합니다.

DECLARE @g1 geometry= 'LINESTRING EMPTY';  
DECLARE @g2 geometry= 'LINESTRING(1 1, 3 3)';  
DECLARE @g3 geometry= 'LINESTRING(1 1, 3 3, 2 4, 2 0)';  
DECLARE @g4 geometry= 'LINESTRING(1 1, 3 3, 2 4, 2 0, 1 1)';  
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();

다음 LineString 인스턴스는 유효하지 않습니다.

DECLARE @g1 geometry = 'LINESTRING(1 4, 3 4, 2 4, 2 0)';  
DECLARE @g2 geometry = 'LINESTRING(1 1, 1 1)';  
SELECT @g1.STIsValid(), @g2.STIsValid();

Warning

LineString 겹침 감지는 정확한 부동 소수점 계산을 기반으로 합니다.

예제

예 A.

다음 예에서는 세 점이 있고 SRID가 0인 geometry``LineString 인스턴스를 만드는 방법을 보여 줍니다.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(1 1, 2 4, 3 9)', 0);

예 2.

LineString 인스턴스의 각 포인트에는 Z(높이) 및 M(측정값)값이 포함될 수 있습니다. 다음 예제는 위의 예제에서 만든 LineString 인스턴스에 M값을 추가합니다. M 및 Z는 Null 값이 될 수 있습니다.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(1 1 NULL 0, 2 4 NULL 12.3, 3 9 NULL 24.5)', 0);

예제 C.

다음 예에서는 동일한 점 두 개로 geometry LineString 인스턴스를 만드는 방법을 보여 줍니다. IsValid에 대한 호출은 LineString 인스턴스가 유효하지 않음을 나타내며 MakeValid 호출 시 LineString 인스턴스가 Point로 변환됩니다.

DECLARE @g geometry  
SET @g = geometry::STGeomFromText('LINESTRING(1 3, 1 3)',0);  
IF @g.STIsValid() = 1  
  BEGIN  
     SELECT @g.ToString() + ' is a valid LineString.';    
  END  
ELSE  
  BEGIN  
     SELECT @g.ToString() + ' is not a valid LineString.';  
     SET @g = @g.MakeValid();  
     SELECT @g.ToString() + ' is a valid Point.';    
  END

결과 집합은 다음과 같습니다.

LINESTRING(1 3, 1 3) is not a valid LineString  
POINT(1 3) is a valid Point.

참고 항목

STLength(기하학 데이터 형식)
STStartPoint(지역 데이터 형식)
STEndpoint(geometry 데이터 형식)
STPoint(geometry 데이터 형식)
STNumPoints(geometry 데이터 형식)
STIsRing(geometry 데이터 형식)
STIsClosed(geometry 데이터 형식)
STPointOnSurface(geometry 데이터 형식)
공간 데이터(SQL Server)

다음을 통해 공유