st_collect 함수

적용 대상:예 Databricks Runtime 18 LTS 이상으로 표시된 확인

메모

Databricks Runtime 18은 Databricks Runtime 18.0, 18.1 및 18.2보다 최신입니다. 이전에 번호가 매겨진 버전으로 제공되었던 기능은 이제 Databricks Runtime 18에 대한 날짜가 지정된 업데이트로 제공됩니다. 자세한 내용은 통합 릴리스 정보 정보를 참조하세요.

Important

GEOGRAPHY 값에 대한 지원은 공개 미리 보기로 제공됩니다. GEOMETRY 값에 대한 지원은 일반적으로 사용할 수 있습니다.

값 배열 GEOGRAPHY 또는 GEOMETRY 값을 단일 다중점, 다중 줄 바꿈, 다각형 또는 기하 도형 컬렉션으로 수집합니다.

Syntax

st_collect ( geoArray )

인수

  • geoArray: 값 배열 GEOGRAPHY 또는 값 배열 GEOMETRY 입니다.

Returns

다중점, 다중 줄 바꿈, 다각형 또는 GEOGRAPHY기하 도형 컬렉션을 나타내는 형식 GEOMETRY 또는 값입니다.

입력 배열의 모든 NULL 값은 무시됩니다. 출력 형식은 입력이 아닌NULL 기하 도형의 형식에 따라 달라집니다.

  • 요소가 아닌 모든NULL 요소가 점인 경우 다중 지점을 반환합니다.
  • 모든 비-NULL 요소가 줄 바꿈인 경우 다중 줄 문자열을 반환합니다.
  • 모든 비 요소가NULL 다각형인 경우 다각형을 반환합니다.
  • 그렇지 않으면 기하 도형 컬렉션을 반환합니다.

각 출력에는 배열이 아닌NULL 요소당 하나의 요소가 포함됩니다.

다중 형식 입력(다중점, 다중 줄 바꿈, 다각형) 및 기하 도형 컬렉션 입력은 결과 기하 도형 컬렉션의 요소로 유지됩니다. 평면화되지 않습니다.

출력의 SRID 값은 입력이 아닌NULL 기하 도형의 일반적인 SRID 값입니다.

출력의 차원은 입력이 아닌NULL 기하 도형의 최대 공통 차원입니다.

입력 배열이 비어 있거나 값만 NULL 포함된 경우 2D 빈 기하 도형 컬렉션이 반환됩니다. 이 경우 출력의 SRID는 다음과 같이 결정됩니다.

  • 입력 배열의 요소 형식이 GEOGRAPHY(ANY)면 출력의 SRID입니다 4326.
  • 입력 배열의 요소 형식이 GEOMETRY(ANY)면 출력의 SRID입니다 0.
  • 그렇지 않으면 출력의 SRID는 입력 배열의 요소 형식입니다.

입력이 NULL인 경우 함수는 NULL를 반환합니다.

오류 조건

  • 입력이 아닌NULL 두 기하 도형에 서로 다른 SRID 값이 있으면 함수는 ST_DIFFERENT_SRID_VALUES 반환합니다.

예제

-- Collects an array of points into a multipoint.
> SELECT st_astext(st_collect(array(st_geomfromtext('POINT(1 2)'),st_geomfromtext('POINT(3 4)'))));
  MULTIPOINT((1 2),(3 4))
-- Collects an array of polygons into a multipolygon.
> SELECT st_astext(st_collect(array(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'))));
  MULTIPOLYGON(((0 0,10 0,10 10,0 10,0 0)))
-- Collects an array of mixed geometry kinds into a geometry collection.
> SELECT st_astext(st_collect(array(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'),st_geomfromtext('LINESTRING(1 2,3 4)'))));
  GEOMETRYCOLLECTION(POLYGON((0 0,10 0,10 10,0 10,0 0)),LINESTRING(1 2,3 4))
-- Returns the 2D empty geometry collection for an empty input array.
> SELECT st_astext(st_collect(array()));
  GEOMETRYCOLLECTION EMPTY
-- Returns NULL for a NULL input.
> SELECT st_collect(NULL);
  NULL
  • Last updated on