st_contains 函数

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

Important

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

如果第一个 GEOMETRY 包含第二 GEOMETRY个值,则返回 true。

Syntax

st_contains ( geoExpr1, geoExpr2 )

Arguments

  • geoExpr1:第一个 GEOMETRY 值。
  • geoExpr2:第二个 GEOMETRY 值。

Returns

如果第一个几何图形包含第二个几何图形,则返回 true。 目前,表达式不支持几何图形集合。 有关几何图形包含另一个几何图形的含义的更多详细信息,请参阅 DE-9IM 矩阵定义中的 Contains 谓词。

Error conditions

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

Examples

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(1 1)'))
  true

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 0)'))
  false

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 6)'))
  false