适用于:
Databricks SQL
Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
如果两个输入 GEOMETRY 值相互接触,则返回 true。
语法
st_touches ( geo1, geo2 )
论据
-
geo1:第一个GEOMETRY值。 -
geo2:第二个GEOMETRY值。
退货
类型的 BOOLEAN值,指示两个输入 GEOMETRY 值是否相互接触。
该函数不支持几何图形集合。
有关更多详细信息和正式定义,请参阅 DE-9IM 矩阵定义中的 Touches 谓词。
如果任何输入为NULL,该函数将返回NULL。
错误条件
- 如果任一输入几何图形是几何图形集合,函数将返回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果输入几何图形没有相同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
-- 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