ST_COLLECT
ST_COLLECT
ST_COLLECT에는 두 가지 형태가 있어요.
- 스칼라(Scalar): 이 함수는 두 GEOGRAPHY 객체를 하나로 결합해요.
- 집계(Aggregate): 이 함수는 열의 모든 GEOGRAPHY 객체를 하나의 GEOGRAPHY 객체로 결합해요.
본문
구문
Scalar:
ST_COLLECT( <geography_expression_1> , <geography_expression_2> )
Aggregate:
ST_COLLECT( <geography_expression_1> )
인자
geography_expression_1
- GEOGRAPHY 객체예요.
geography_expression_2
- GEOGRAPHY 객체예요.
반환
이 함수는 GEOGRAPHY 타입의 값을 반환해요.
사용법 참고 사항
- g1과 g2가 모두 Point 객체라면 결과는 두 Point를 포함하는 MultiPoint 객체예요. 마찬가지로 g1과 g2가 모두 LineString 객체라면 결과는 MultiLineString 객체예요. 이런 식으로 동작해요.
- g1과 g2가 서로 다른 유형의 지리공간 객체이거나, 입력 GEOGRAPHY 객체 중 하나 이상이 컬렉션(예: MultiLineString, GeometryCollection 또는 FeatureCollection)이라면 결과는 두 입력 객체를 모두 포함하는 GeometryCollection이에요.
예제
아래의 쿼리들은 ST_COLLECT 함수의 스칼라 및 집계 사용법을 모두 보여줘요.
테이블을 만들고 로드해요.
CREATE TABLE geo3 (g1 GEOGRAPHY, g2 GEOGRAPHY);
INSERT INTO geo3 (g1, g2) VALUES
( 'POINT(-180 -90)', 'POINT(-45 -45)' ),
( 'POINT( 0 0)', 'POINT(-60 -60)' ),
( 'POINT(+180 +90)', 'POINT(+45 +45)' );
이것은 ST_COLLECT를 스칼라 함수로 호출해 같은 행의 두 점을 모두 포함하는 MultiPoint 값을 만든다.
-- Scalar function:
SELECT ST_COLLECT(g1, g2) FROM geo3;
+------------------------+
| ST_COLLECT(G1, G2) |
|------------------------|
| { |
| "coordinates": [ |
| [ |
| -180, |
| -90 |
| ], |
| [ |
| -45, |
| -45 |
| ] |
| ], |
| "type": "MultiPoint" |
| } |
| { |
| "coordinates": [ |
| [ |
| 0, |
| 0 |
| ], |
| [ |
| -60, |
| -60 |
| ] |
| ], |
| "type": "MultiPoint" |
| } |
| { |
| "coordinates": [ |
| [ |
| 180, |
| 90 |
| ], |
| [ |
| 45, |
| 45 |
| ] |
| ], |
| "type": "MultiPoint" |
| } |
+------------------------+
이것은 ST_COLLECT를 집계 함수로 호출해 같은 열의 모든 점을 포함하는 MultiPoint 값을 만든다.
-- Aggregate function:
SELECT ST_COLLECT(g1), ST_COLLECT(g2) FROM geo3;
+------------------------+------------------------+
| ST_COLLECT(G1) | ST_COLLECT(G2) |
|------------------------+------------------------|
| { | { |
| "coordinates": [ | "coordinates": [ |
| [ | [ |
| -180, | -45, |
| -90 | -45 |
| ], | ], |
| [ | [ |
| 0, | -60, |
| 0 | -60 |
| ], | ], |
| [ | [ |
| 180, | 45, |
| 90 | 45 |
| ] | ] |
| ], | ], |
| "type": "MultiPoint" | "type": "MultiPoint" |
| } | } |
+------------------------+------------------------+
이것은 먼저 각 열에 대해 ST_COLLECT를 집계 함수로 호출해 각 열의 모든 점을 포함하는 MultiPoint 값을 만든 다음, 그 두 MultiPoint 값에 ST_COLLECT를 호출해 두 열의 모든 점을 포함하는 GeometryCollection을 만든다. 결과로 나온 GeometryCollection은 계층적이에요.
-- Aggregate and then Collect:
SELECT ST_COLLECT(ST_COLLECT(g1), ST_COLLECT(g2)) FROM geo3;
+--------------------------------------------+
| ST_COLLECT(ST_COLLECT(G1), ST_COLLECT(G2)) |
|--------------------------------------------|
| { |
| "geometries": [ |
| { |
| "coordinates": [ |
| [ |
| -180, |
| -90 |
| ], |
| [ |
| 0, |
| 0 |
| ], |
| [ |
| 180, |
| 90 |
| ] |
| ], |
| "type": "MultiPoint" |
| }, |
| { |
| "coordinates": [ |
| [ |
| -45, |
| -45 |
| ], |
| [ |
| -60, |
| -60 |
| ], |
| [ |
| 45, |
| 45 |
| ] |
| ], |
| "type": "MultiPoint" |
| } |
| ], |
| "type": "GeometryCollection" |
| } |
+--------------------------------------------+