funktion st_makeline

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 ett linjevärde GEOMETRY vars punkter är de icke-tomma punkterna i geometrierna i indatamatrisen med geometrier, som förväntas vara punkter, linjer eller flera punkter.

Syntax

st_makeline ( geoArray )

Arguments

• geoArray: En ARRAY med GEOMETRY värden.

Returns

Ett värde av typen GEOMETRY, som representerar en linjedragning.

Ordningen på punkterna bevaras i utdatalinjerna. Alla NULL värden i indatamatrisen ignoreras.

SRID-värdet för utdatalinjerna är det gemensamma SRID-värdet för indatageometrierna.

Dimensionen för utdatalinjerna är den maximala gemensamma dimensionen för indatageometrierna.

Om indatamatrisen är tom returneras den tomma 2D-linjeringen. SRID för den returnerade linjedragningen är 0 i det här fallet. Om alla indatageometrier är tomma returneras den tomma 2D-linjeringen. Om det totala antalet icke-tomma punkter i alla indatageometrier är en returnerar vi en linjedragning med två punkter, som båda är lika med den unika icke-tomma punkten i indata.

Funktionen returnerar NULL om någon av indata är NULL.

Feltillstånd

• Om någon av indatageometrierna inte är en punkt, linjering eller multipunkt returnerar funktionen ST_INVALID_ARGUMENT. INVALID_TYPE.
• Om indatageometrierna inte har samma SRID-värde returnerar funktionen ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns a linestring with the points of the input geometries.
> SELECT st_astext(st_makeline(array(st_geomfromtext('POINT(1 2)'),st_geomfromtext('MULTIPOINT(5 6,7 8)'),st_geomfromtext('LINESTRING(5 6,7 8,-1 -3,-7 -9,-12 -20)'))));
  LINESTRING(1 2,5 6,7 8,5 6,7 8,-1 -3,-7 -9,-12 -20)

Relaterade funktioner

• st_makepolygon funktion
• st_point funktion