Функция st_startpoint

Применяется к: Databricks SQL Databricks Runtime 17.1 и более поздних версий

Возвращает первую точку входных 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)

Связанные функции

• st_endpoint функция
• st_geometryn функция