适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
如果第一个 GEOMETRY
覆盖第二个 GEOMETRY
,则返回 true。
语法
st_covers ( geoExpr1, geoExpr2 )
论据
-
geoExpr1
:第一个GEOMETRY
值。 -
geoExpr2
:第二个GEOMETRY
值。
退货
如果第一个几何图形覆盖第二个几何图形,则返回 true。 目前,表达式不支持几何图形集合。 有关几何图形覆盖另一个几何图形的含义的更多详细信息,请参阅 DE-9IM 矩阵定义中的 Cover 谓词。
错误条件
- 如果两个输入几何图形中的任何一个是几何图形集合,则返回错误。
- 如果两个输入几何图形具有不同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(1 1)'));
true
> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 0)'));
true
> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 6)'));
false