适用于:
Databricks SQL
Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
如果输入地理空间值为非空线字符串,则返回输入 GEOGRAPHY 或 GEOMETRY 值的第一个点。
Syntax
st_startpoint ( geoExpr )
Arguments
-
geoExpr:一个GEOGRAPHY或者GEOMETRY值,用以表示线字符串。
Returns
类型为GEOGRAPHY或GEOMETRY的值,代表线字符串的第一个点。
输出点的 SRID 值与输入值的值相同。
输出点的维度与输入线字符串的维度相同。
如果输入为 NULL.,则函数返回 NULL 。
错误条件
- 如果值
geoExpr不是线字符串,函数将返回 ST_INVALID_ARGUMENT。INVALID_TYPE。 - 如果值为
geoExpr空行字符串,则函数将返回 ST_INVALID_ARGUMENT。EMPTY_LINESTRING。
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)