st_makeline Funkce

Platí pro: Kontrola SQL Databricks Databricks Runtime 17.1 a vyšší

Important

Tato funkce je ve verzi Public Preview.

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Vrátí hodnotu přímky GEOMETRY , jejíž body jsou neprázdné body geometrie ve vstupním poli geometrie, které mají být body, spojnice nebo více bodů.

Syntax

st_makeline ( geoArray )

Arguments

• geoArray: Seznam hodnot ARRAYGEOMETRY.

Returns

Hodnota typu GEOMETRY, představující linestring.

Pořadí bodů je zachováno ve výstupním řádku. Všechny NULL hodnoty ve vstupním poli se ignorují.

Hodnota SRID výstupního linestringu je společná hodnota SRID vstupních geometrií.

Rozměr výstupního vedení je maximální společná dimenze vstupních geometrií.

Pokud je vstupní pole prázdné, vrátí se prázdný 2D čárový řetězec. V tomto případě je SRID vráceného linestringu 0. Pokud jsou všechny vstupní geometrie prázdné, vrátí se 2D prázdný spojnicový řetězec. Pokud je celkový počet neprázdných bodů ve všech vstupních geometriích jeden, vrátíme přímku se dvěma body, z nichž oba jsou stejné jako jedinečný neprázdný bod ve vstupu.

Funkce vrátí NULL , pokud je některý ze vstupů NULL.

Chybové podmínky

• Pokud některá ze vstupních geometrií není bod, přímka nebo více bodů, vrátí funkce ST_INVALID_ARGUMENT. INVALID_TYPE.
• Pokud vstupní geometrie nemají stejnou hodnotu SRID, vrátí funkce 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)

Související funkce

• st_makepolygon funkce
• st_point funkce