适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
如果输入地理空间值为非空线字符串,则返回输入 GEOGRAPHY
或 GEOMETRY
值的最后一个点。
语法
st_endpoint ( geoExpr )
论据
-
geoExpr
:一个GEOGRAPHY
或者GEOMETRY
值,用以表示线字符串。
退货
类型为GEOGRAPHY
或GEOMETRY
的值,表示线串的最后一个点。
输出点的 SRID 值与输入值的值相同。
输出点的维度与输入线字符串的维度相同。
如果输入为 NULL
.,则函数返回 NULL
。
错误条件
- 如果该值
geoExpr
不是线字符串,则函数将返回 ST_INVALID_ARGUMENT_TYPE。 - 如果值为
geoExpr
空行字符串,则函数将返回 ST_INVALID_ARGUMENT_TYPE。
例子
-- Returns the endpoint of a linestring geometry.
> SELECT st_asewkt(st_endpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
SRID=4326;POINT(5 6)
-- Returns the endpoint of a linestring geography with Z and M coordinates.
> SELECT st_asewkt(st_endpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
SRID=4326;POINT ZM (5 6 7 8)