適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
將兩個輸入 GEOMETRY 值的點集差異傳回為 2D GEOMETRY 值。
Syntax
st_difference ( geoExpr1, geoExpr2 )
Arguments
-
geoExpr1:第一個GEOMETRY值。 -
geoExpr2:第二個GEOMETRY值。
Returns
類型的 GEOMETRY值,表示兩個輸入幾何的點集差異。
傳回 GEOMETRY 值的 SRID 是輸入幾何的通用 SRID。
如果任何輸入為 NULL,則函式會傳NULL回 。
錯誤條件
- 如果兩個輸入幾何圖形中的任何一個是幾何集合,則函式會傳回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果兩個輸入幾何有不同的 SRID 值,函式會 傳回ST_DIFFERENT_SRID_VALUES。
Examples
> SELECT st_astext(st_difference(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
MULTIPOINT((-1 8),(5 6))