适用于：
Databricks Runtime 18.0 及更高版本
重要
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库，请参阅 SQL 仓库类型。
返回与第二个GEOMETRY值在欧几里得距离上最近的、第一个GEOMETRY值上某点的2D投影。
Syntax
st_closestpoint ( geoExpr1, geoExpr2 )
Arguments
-
geoExpr1：第一个GEOMETRY值。 -
geoExpr2：第二个GEOMETRY值。
退货
返回与第二个GEOMETRY值在欧几里得距离上最近的、第一个GEOMETRY值上某点的2D投影。 如果两个输入几何图形具有不同的 SRID 值，表达式将返回 ST_DIFFERENT_SRID_VALUES 错误。 返回点的 SRID 值与输入几何图形的常见 SRID 值相同。 如果两个输入几何图形中的任何一个为空，表达式将返回 2D 空点。
NULL 如果两个输入几何图形中的任何一个为空，则返回 。
错误条件
- 如果两个输入几何图形具有不同的 SRID 值，函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
> SELECT st_closestpoint(st_geomfromwkt('MULTIPOINT ZM (-10 10 -1 -10,2 10 -2 -20,20 10 -3 -30)', 3857), st_geomfromwkt('POINT Z (0 0 300)', 3857));
SRID=3857;POINT(2 10)