共用方式為

st_difference 函数

适用于：检查标记为“是”的 Databricks SQL 检查标记为“是”是 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))