st_makeline Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Retorna um valor de cadeia de caracteres GEOMETRY de linha cujos pontos são os pontos não vazios das geometrias na matriz de entrada de geometrias, que se espera que sejam pontos, cadeias de caracteres de linha ou multipontos.

Syntax

st_makeline ( geoArray )

Arguments

• geoArray: Um ARRAY de GEOMETRY valores.

Returns

Um valor do tipo GEOMETRY, que representa uma cadeia de caracteres de linha.

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

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

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

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

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

Condições de erro

• Se qualquer uma das geometrias de entrada não for um ponto, cadeia de caracteres de linha ou multiponto, 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