st_makeline 함수

적용 대상: Databricks SQL Databricks Runtime 17.1 이상으로 표시

기하 도형의 입력 배열에서 점, 선, 또는 다중점으로 예상되는 기하 도형의 비어 있지 않은 점들로 이루어진 라인스트링 GEOMETRY 값을 반환합니다.

Syntax

st_makeline ( geoArray )

Arguments

• geoArray ARRAY: 일련의 GEOMETRY 값.

Returns

GEOMETRY 유형의 값을 나타내는 선형 문자열입니다.

점의 순서는 출력 라인스트링에서 보존됩니다. 입력 배열의 모든 NULL 값은 무시됩니다.

출력 줄 문자열의 SRID 값은 입력 기하 도형의 일반적인 SRID 값입니다.

출력 줄 문자열의 차원은 입력 기하 도형의 최대 공통 차원입니다.

입력 배열이 비어 있으면 2D 빈 줄 문자열이 반환됩니다. 이 경우 반환된 줄 바꿈의 SRID는 0입니다. 모든 입력 기하 도형이 비어 있으면 2D 빈 라인 스트링이 반환됩니다. 모든 입력 기하 도형에서 비어있지 않은 점의 총 수가 1이면 두 점이 있는 줄 문자열을 반환합니다. 두 점 모두 입력에서 비어있지 않은 고유한 점과 같습니다.

입력 중 하나라도 NULL인 경우 함수는 NULL을 반환합니다.

오류 조건

• 입력 기하 도형이 점, 라인스트링 또는 다중점이 아닌 경우, 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE를 반환합니다.
• 입력 기하 도형에 동일한 SRID 값이 없으면 함수는 ST_DIFFERENT_SRID_VALUES 반환합니다.

Examples

-- Returns a linestring with the points of the input geometries.
> SELECT st_astext(st_makeline(array(st_geomfromtext('POINT(1 2)'),st_geomfromtext('MULTIPOINT(5 6,7 8)'),st_geomfromtext('LINESTRING(5 6,7 8,-1 -3,-7 -9,-12 -20)'))));
  LINESTRING(1 2,5 6,7 8,5 6,7 8,-1 -3,-7 -9,-12 -20)

관련된 함수

• st_makepolygon 함수
• st_point 함수