st_makeline Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna um valor linestring GEOMETRY cujos pontos são os pontos não vazios das geometrias na matriz de entrada de geometrias, que devem ser pontos, linhas de linha ou vários pontos.

Syntax

st_makeline ( geoArray )

Arguments

• geoArray: um ARRAY dos GEOMETRY valores.

Returns

Um valor de tipo GEOMETRY, representando uma linha de linha.

A ordem dos pontos é preservada na linha de saída. Todos NULL os valores na matriz de entrada são ignorados.

O valor SRID da linha de saída é o valor SRID comum das geometrias de entrada.

A dimensão da linha de saída é a dimensão máxima comum das geometrias de entrada.

Se a matriz de entrada estiver vazia, a linha 2D vazia será retornada. O SRID do linestring retornado é 0 neste caso. Se todas as geometrias de entrada estiverem vazias, a linha 2D vazia será retornada. Se o número total de pontos não vazios em todas as geometrias de entrada for um, retornaremos uma linha com dois pontos, ambos iguais ao ponto não vazio exclusivo na entrada.

A função retornará NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se qualquer uma das geometrias de entrada não for um ponto, linestring ou multipoint, a função retornará ST_INVALID_ARGUMENT. INVALID_TYPE.
• Se as geometrias de entrada não tiverem o mesmo valor SRID, a função retornará 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)

Funções relacionadas

• st_makepolygon função
• st_point função