適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
將兩個輸入 GEOMETRY 值的點集聯集以 2D 幾何圖形的形式傳回。
Syntax
st_union ( geo1, geo2 )
Arguments
-
geo1:第一個GEOMETRY值。 -
geo2:第二個GEOMETRY值。
Returns
類型為 GEOMETRY 的值,將兩個輸入 GEOMETRY 值的點集聯集表示為一個2D幾何圖形。
傳回 GEOMETRY 值的 SRID 是兩個輸入 GEOMETRY 值的通用 SRID。
如果任何輸入為 NULL,則函式會傳NULL回 。
錯誤條件
- 如果輸入幾何沒有相同的 SRID 值,函式會 傳回ST_DIFFERENT_SRID_VALUES。
Examples
-- Returns union of multipoint and polygon.
> SELECT st_astext(st_union(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
GEOMETRYCOLLECTION(POINT(-1 8),POINT(5 6),POLYGON((0 0,0 10,10 0,0 0)))
-- Returns union of two overlapping polygons.
> SELECT st_astext(st_union(st_geomfromtext('POLYGON((0 0,5 0,5 5,0 5,0 0))'),st_geomfromtext('POLYGON((3 3,8 3,8 8,3 8,3 3))')));
POLYGON((5 3,5 0,0 0,0 5,3 5,3 8,8 8,8 3,5 3))