적용 대상:
Databricks SQL Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
두 입력 GEOMETRY 값의 점 집합 차이를 2D GEOMETRY 값으로 반환합니다.
Syntax
st_difference ( geoExpr1, geoExpr2 )
Arguments
-
geoExpr1: 첫 번째GEOMETRY값입니다. -
geoExpr2: 두 번째GEOMETRY값입니다.
Returns
두 입력 기하 도형의 점 집합 차이를 나타내는 형식 GEOMETRY의 값입니다.
반환된 GEOMETRY 값의 SRID는 입력 기하 도형의 일반적인 SRID입니다.
입력 중 하나라도 NULL인 경우 함수는 NULL을 반환합니다.
오류 조건
- 두 입력 지오메트리 중 하나라도 지오메트리 컬렉션인 경우 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE을 반환합니다.
- 두 입력 기하 도형의 SRID 값이 다르면 함수는 ST_DIFFERENT_SRID_VALUES 반환합니다.
Examples
> SELECT st_astext(st_difference(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
MULTIPOINT((-1 8),(5 6))