ST_WITHIN

ST_WITHIN

첫 번째 지리공간 객체가 두 번째 지리공간 객체에 완전히 포함되면 true를 반환해요. 다시 말해:

  • 첫 번째 GEOGRAPHY 객체 g1이 두 번째 GEOGRAPHY 객체 g2에 완전히 포함돼요.
  • 첫 번째 GEOMETRY 객체 g1이 두 번째 GEOMETRY 객체 g2에 완전히 포함돼요.

ST_WITHIN(g1, g2)를 호출하는 것은 ST_CONTAINS(g2, g1)을 호출하는 것과 동등해요.

ST_COVEREDBY와 ST_WITHIN이 비슷해 보일 수 있지만, 두 함수에는 미묘한 차이가 있어요. "covered by"와 "within"의 차이에 대한 자세한 내용은 DE-9IM(Dimensionally Extended 9-Intersection Model) 문서를 참고해요.

출처: Snowflake ST_WITHIN 함수 문서

본문

참고: 이 함수는 GeometryCollection 또는 FeatureCollection을 입력 값으로 사용하는 것을 지원하지 않아요.

팁: 검색 최적화 서비스(Search Optimization Service)를 사용하면 이 함수를 호출하는 쿼리의 성능을 개선할 수 있어요. 자세한 내용은 검색 최적화 서비스 문서를 참고해요.

참고 항목: ST_CONTAINS, ST_COVEREDBY

구문 (Syntax)

ST_WITHIN(  ,  )

ST_WITHIN(  ,  )

인자 (Arguments)

  • geography_expression_1 — GeometryCollection 또는 FeatureCollection이 아닌 GEOGRAPHY 객체예요.
  • geography_expression_2 — GeometryCollection 또는 FeatureCollection이 아닌 GEOGRAPHY 객체예요.
  • geometry_expression_1 — GeometryCollection 또는 FeatureCollection이 아닌 GEOMETRY 객체예요.
  • geometry_expression_2 — GeometryCollection 또는 FeatureCollection이 아닌 GEOMETRY 객체예요.

반환 값 (Returns)

BOOLEAN이에요.

예제 (Examples)

GEOGRAPHY 예제

ST_WITHIN 함수의 간단한 사용 예를 보여줘요:

create table geospatial_table_01 (g1 GEOGRAPHY, g2 GEOGRAPHY);
insert into geospatial_table_01 (g1, g2) values 
    ('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0))', 'POLYGON((1 1, 2 1, 2 2, 1 2, 1 1))');

SELECT ST_WITHIN(g1, g2) 
    FROM geospatial_table_01;
+-------------------+
| ST_WITHIN(G1, G2) |
|-------------------|
| False             |
+-------------------+

더 알아보기