st_startpoint 函数

适用于:已勾选“是”的 Databricks Runtime 17.1 及更高版本

Important

此功能目前以公共预览版提供。

如果输入地理空间值为非空线字符串,则返回输入 GEOGRAPHYGEOMETRY 值的第一个点。 否则返回 NULL

Syntax

st_startpoint ( geoExpr )

Arguments

  • geoExpr:一个GEOGRAPHY或者GEOMETRY值,用以表示线字符串。

Returns

类型为GEOGRAPHYGEOMETRY的值,代表线字符串的第一个点。

输出点的 SRID 值与输入值的值相同。

输出点的维度与输入线字符串的维度相同。

如果输入为 NULL.,则函数返回 NULL

Error conditions

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)