適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
如果兩個輸入 GEOMETRY 值彼此接觸,則傳回 true。
Syntax
st_touches ( geo1, geo2 )
Arguments
-
geo1:第一個GEOMETRY值。 -
geo2:第二個GEOMETRY值。
Returns
類型 BOOLEAN的值 ,指出兩個輸入 GEOMETRY 值是否相互接觸。
此函數不支援幾何集合。
如需詳細資料及正式定義,請參閱 DE-9IM 矩陣定義中的 Touches 述詞。
如果任何輸入為 NULL,則函式會傳NULL回 。
錯誤條件
- 如果任何輸入幾何是幾何集合,則函式會傳回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果輸入幾何沒有相同的 SRID 值,函式會 傳回ST_DIFFERENT_SRID_VALUES。
Examples
-- Returns false when geometries do not touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 10)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
false
-- Returns true when geometries touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 5)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
true