적용 대상:
Databricks SQL Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
첫 번째 GEOMETRY 값이 두 번째 GEOMETRY 값 내에 있으면 true를 반환합니다.
Syntax
st_within ( geo1, geo2 )
Arguments
-
geo1: 첫 번째GEOMETRY값입니다. -
geo2: 두 번째GEOMETRY값입니다.
Returns
첫 번째 BOOLEAN 값이 두 번째 GEOMETRY 값 내에 있는지 여부를 나타내는 형식GEOMETRY의 값입니다.
이 함수는 기하 도형 컬렉션을 지원하지 않습니다.
자세한 내용 및 공식 정의는 DE-9IM 매트릭스 정의의 Within 조건자를 참조하세요.
입력 중 하나라도 NULL인 경우 함수는 NULL을 반환합니다.
오류 조건
- 입력 기하 도형이 기하 도형 컬렉션인 경우 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE을 반환합니다.
- 입력 기하 도형에 동일한 SRID 값이 없으면 함수는 ST_DIFFERENT_SRID_VALUES 반환합니다.
Examples
-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false