st_touches 函数

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 17.1 及更高版本

Important

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

注释

此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型

如果两个输入 GEOMETRY 值相互接触,则返回 true。

Syntax

st_touches ( geo1, geo2 )

Arguments

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

Returns

类型的 BOOLEAN值,指示两个输入 GEOMETRY 值是否相互接触。

该函数不支持几何图形集合。

有关更多详细信息和正式定义,请参阅 DE-9IM 矩阵定义中的 Touches 谓词。

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

错误条件

Examples

-- Returns false when geometries do not touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 10)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
  false
-- Returns true when geometries touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 5)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
  true