適用於：
Databricks SQL Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲，請參閱 SQL 倉儲類型。
返回欄中所有幾何圖形的逐點的合併，如果欄包含零行或僅包含NULL值，則返回NULL。
Syntax
st_union_agg ( geoCol )
Arguments
-
geoCol：類型為GEOMETRY的欄位，代表幾何物件。
Returns
類型 GEOMETRY的值 ，代表直欄中所有 GEOMETRY 值的逐點聯集。
輸出 GEOMETRY 一律為二維。
如果欄位有零個資料列或只包含NULL值，則函式會傳回NULL。
錯誤條件
- 如果輸入欄中的兩個
GEOMETRY值具有不同的 SRID 值，則函數會傳回 ST_DIFFERENT_SRID_VALUES。
Examples
-- Returns union of multiple geometries from column.
> SELECT st_astext(st_union_agg(st_geomfromtext(*))) FROM (SELECT * FROM VALUES('POINT(-5 -5)'),('MULTIPOINT(1 2,8 8,5 9,-7 -7,EMPTY)'),('MULTILINESTRING(EMPTY,(5 5,9 9),(9 9,15 15))'),('POLYGON((0 0,10 0,10 10,0 10,0 0))'));
GEOMETRYCOLLECTION(MULTIPOINT((-7 -7),(-5 -5)),LINESTRING(10 10,15 15),POLYGON((0 0,10 0,10 10,0 10,0 0)))
-- Returns NULL for empty result set.
> SELECT st_union_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
NULL