Teilen über


st_makeline-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt einen Linienzugwert GEOMETRY zurück, dessen Punkte die nicht-leeren Punkte der Geometrien im Eingabearray sind, die als Punkte, Linienzüge oder Multipoints erwartet werden.

Syntax

st_makeline ( geoArray )

Arguments

  • geoArray: Eine ARRAY von GEOMETRY-Werten.

Returns

Ein Wert vom Typ GEOMETRY, der eine Linienzeichenfolge darstellt.

Die Reihenfolge der Punkte wird in der Ausgabezeile beibehalten. Alle NULL Werte im Eingabearray werden ignoriert.

Der SRID-Wert der Ausgabezeilenzeichenfolge ist der gemeinsame SRID-Wert der Eingabegeometrien.

Die Dimension der Ausgabezeilenzeichenfolge ist die maximale gemeinsame Dimension der Eingabegeometrien.

Wenn das Eingabearray leer ist, wird die leere 2D-Linienzeichenfolge zurückgegeben. Die SRID der zurückgegebenen Linienzeichenfolge ist in diesem Fall 0. Wenn alle Eingabegeometrien leer sind, wird die leere 2D-Linienzeichenfolge zurückgegeben. Wenn die Gesamtanzahl der nicht leeren Punkte über alle Eingabegeometrien hinweg eins ist, geben wir eine Linienzeichenfolge mit zwei Punkten zurück, die beide dem eindeutigen nicht leeren Punkt in der Eingabe entsprechen.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

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)