适用于: Databricks SQL
 Databricks SQL  Databricks Runtime 17.1 及更高版本
 Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
将两个输入 GEOMETRY 值的点集差异作为 2D GEOMETRY 值返回。
Syntax
st_difference ( geoExpr1, geoExpr2 )
Arguments
- 
              geoExpr1:第一个GEOMETRY值。
- 
              geoExpr2:第二个GEOMETRY值。
Returns
类型为 GEOMETRY 的值,表示两个输入几何体的点集差。
返回 GEOMETRY 值的 SRID 是输入几何图形的常见 SRID。
如果任何输入为NULL,该函数将返回NULL。
错误条件
- 如果两个输入几何图形中的任何一个是几何图形集合,函数将返回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果两个输入几何图形具有不同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
Examples
> 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))