适用于: Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
如果输入地理空间值为非空线字符串,则返回输入 GEOGRAPHY
或 GEOMETRY
值的第一个点。 否则返回 NULL
。
Syntax
st_startpoint ( geoExpr )
Arguments
-
geoExpr
:一个GEOGRAPHY
或者GEOMETRY
值,用以表示线字符串。
Returns
类型为GEOGRAPHY
或GEOMETRY
的值,代表线字符串的第一个点。
输出点的 SRID 值与输入值的值相同。
输出点的维度与输入线字符串的维度相同。
如果输入为 NULL
.,则函数返回 NULL
。
Error conditions
- 如果该值
geoExpr
不是线字符串,则函数将返回 ST_INVALID_ARGUMENT_TYPE。 - 如果值为
geoExpr
空行字符串,则函数将返回 ST_INVALID_ARGUMENT_TYPE。
Examples
-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)))
SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')))
SRID=4326;POINT ZM (1 2 3 4)