Comparteix via


st_makeline Función

Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve un valor de línea GEOMETRY cuyos puntos son los puntos no vacíos de las geometrías de la matriz de geometrías de entrada, que se espera que sean puntos, líneas o multipuntos.

Syntax

st_makeline ( geoArray )

Arguments

  • geoArray: Un ARRAY de GEOMETRY valores.

Returns

Valor de tipo GEOMETRY, que representa una cadena de líneas.

El orden de los puntos se conserva en la cadena de líneas de salida. Los NULL valores de la matriz de entrada se omiten.

El valor SRID de la linestring de salida es el valor SRID común de las geometrías de entrada.

La dimensión del linestring de salida es la dimensión común máxima de las geometrías de entrada.

Si la matriz de entrada está vacía, se devuelve la cadena de línea vacía 2D. El SRID de la cadena de línea devuelta es 0 en este caso. Si todas las geometrías de entrada están vacías, se devuelve la cadena de línea vacía 2D. Si el número total de puntos no vacíos en todas las geometrías de entrada es uno, se devuelve una cadena de líneas con dos puntos, ambos son iguales al punto no vacío único de la entrada.

La función devuelve NULL si alguna de las entradas es NULL.

Condiciones de error

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)