st_equals 函数

适用于:已勾选“是”的 Databricks Runtime 17.1 及更高版本

Important

此功能目前以公共预览版提供。

如果两个几何图形在几何上相等,则返回 true,这意味着它们对应于同一个点集。

Syntax

st_equals ( geo1, geo2 )

Arguments

  • geo1:第一个 GEOMETRY 值。
  • geo2:第二个 GEOMETRY 值。

Returns

一个 BOOLEAN 类型的值。

有关两个几何图形相等的更多详细信息,请参阅 DE-9IM 矩阵定义中的 Equals 谓词。

如果任何输入为NULL,该函数将返回NULL

Error conditions

  • 如果两个输入几何图形中的任何一个是几何图形集合,则返回错误。
  • 如果两个输入几何图形具有不同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES

Examples

-- Returns false as a point and polygon are not equal.
> SELECT st_equals(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'))
  false
-- Returns true as the two polygons are geometrically equal.
> SELECT st_equals(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'))
  true