共用方式為

st_covers 函数

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