适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
以 2D GEOMETRY
形式返回两个输入几何图形的点集差。
语法
st_difference ( geoExpr1, geoExpr2 )
论据
-
geoExpr1
:第一个GEOMETRY
值。 -
geoExpr2
:第二个GEOMETRY
值。
退货
类型为 GEOMETRY
的值,表示两个输入几何体的点集差。
返回 GEOMETRY
值的 SRID 是输入几何图形的常见 SRID。
如果任何输入为NULL
,该函数将返回NULL
。
错误条件
- 如果两个输入几何图形中的任何一个是几何图形集合,则返回错误。
- 如果两个输入几何图形具有不同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
> SELECT st_astext(st_difference(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
MULTIPOINT((-1 8),(5 6))