适用于：
Databricks SQL Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库，请参阅 SQL 仓库类型。
如果第一 GEOMETRY 个值位于第二 GEOMETRY 个值内，则返回 true。
Syntax
st_within ( geo1, geo2 )
Arguments
-
geo1：第一个GEOMETRY值。 -
geo2：第二个GEOMETRY值。
Returns
类型的 BOOLEAN值，指示第一 GEOMETRY 个值是否在第二 GEOMETRY 个值内。
该函数不支持几何图形集合。
有关更多详细信息和正式定义，请参阅 DE-9IM 矩阵定义中的 Within 谓词。
如果任何输入为NULL，该函数将返回NULL。
错误条件
- 如果任一输入几何图形是几何图形集合，函数将返回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果输入几何图形没有相同的 SRID 值，函数将返回 ST_DIFFERENT_SRID_VALUES。
Examples
-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false