適用於：
Databricks SQL Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 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