适用于:
Databricks SQL
Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
如果第一个 GEOMETRY 值包含第二 GEOMETRY 个值,则返回 true。
Syntax
st_contains ( geoExpr1, geoExpr2 )
Arguments
-
geoExpr1:第一个GEOMETRY值。 -
geoExpr2:第二个GEOMETRY值。
Returns
类型的 BOOLEAN值,指示第一 GEOMETRY 个值是否包含第二 GEOMETRY 个值。
该函数不支持几何图形集合。
有关更多详细信息和正式定义,请参阅 DE-9IM 矩阵定义中的 Contains 谓词。
错误条件
- 如果两个输入几何图形中的任何一个是几何图形集合,函数将返回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果两个输入几何图形具有不同的 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