适用于:
Databricks SQL
Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
返回两个输入 GEOMETRY 值的点集联合作为 2D 几何图形。
语法
st_union ( geo1, geo2 )
论据
-
geo1:第一个GEOMETRY值。 -
geo2:第二个GEOMETRY值。
退货
类型的 GEOMETRY值,表示两个输入 GEOMETRY 值的点集联合作为 2D 几何图形。
返回 GEOMETRY 值的 SRID 是两个输入 GEOMETRY 值的常见 SRID。
如果任何输入为NULL,该函数将返回NULL。
错误条件
- 如果输入几何图形没有相同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
-- 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))