funktion st_startpoint

Gäller för: Databricks Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Returnerar den första punkten i indata GEOGRAPHY eller GEOMETRY värde, om det geospatiala indatavärdet är en linje som inte är tom.

Syntax

st_startpoint ( geoExpr )

Arguments

• geoExpr: Ett GEOGRAPHY eller GEOMETRY -värde som representerar en linjedragning.

Returns

Ett värde av typen GEOGRAPHY eller GEOMETRY, som representerar den första punkten i linjedragningen.

SRID-värdet för utdatapunkten är detsamma som för indatavärdet.

Dimensionen för utdatapunkten är densamma som för indatalinjerna.

Funktionen returnerar NULL om indata är NULL.

Feltillstånd

• Om värdet för geoExpr inte är en linjedragning returnerar funktionen ST_INVALID_ARGUMENT. INVALID_TYPE.
• Om värdet av geoExpr är en tom linestring returnerar funktionen 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)

Relaterade funktioner

• st_endpoint funktion
• st_geometryn funktion