적용 대상:
Databricks SQL
Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
입력 라인스트링 GEOGRAPHY 또는 GEOMETRY 값에서 n번째 점을 제거합니다.
Syntax
st_removepoint ( geoExpr, indexExpr )
Arguments
-
geoExpr: 줄 문자열을 나타내는 AGEOGRAPHY또는GEOMETRY값입니다. -
indexExprINTEGER: 제거해야 하는 점의 줄 바꿈에서 1부터 시작하는 위치를 나타내는 값입니다.
Returns
GEOGRAPHY 또는 GEOMETRY 유형의 값으로, indexExpr 번째 위치의 점이 제거된 후의 라인스트링을 나타냅니다.
출력 줄 문자열의 SRID 값은 입력 GEOGRAPHY 또는 GEOMETRY 값의 값과 같습니다.
출력 줄 문자열의 차원은 입력 GEOGRAPHY 또는 GEOMETRY 값의 차원과 동일합니다.
입력 중 하나라도 NULL인 경우 함수는 NULL을 반환합니다.
오류 조건
- 값
geoExpr이 라인스트링이 아니거나 빈 라인스트링인 경우 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE을 반환합니다. -
indexExpr의 절대값이 0이거나 라인스트링의 점 수보다 클 경우, 함수는 ST_INVALID_ARGUMENT.INVALID_INDEX_VALUE을 반환합니다.
Examples
-- Returns the linestring after removing the second point counting from the left.
> SELECT st_astext(st_removepoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 2));
LINESTRING(1 2,5 6)
-- Returns the linestring after removing the first point counting from the right.
> SELECT st_asewkt(st_removepoint(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -1));
SRID=4326;LINESTRING(1 2,3 4)