View a markdown version of this page

ST_LineFromMultiPoint - Amazon Redshift

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

ST_LineFromMultiPoint

ST_LineFromMultiPoint retorna uma linestring de uma geometria multiponto de entrada. A ordem dos pontos é preservada. O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) da geometria retornada é o mesmo da geometria de entrada. A dimensão da geometria retornada é a mesma geometria de entrada.

Sintaxe

ST_LineFromMultiPoint(geom)

Argumentos

geom

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. O subtipo deve ser MULTIPOINT.

Tipo de retorno

GEOMETRY

Nulo será retornado se geom for nulo.

Se geom estiver vazio, uma LINESTRING vazia será retornada.

Se geom contém pontos vazios, então esses pontos vazios são ignorados.

Se geom não for um MULTIPOINT, será retornado error.

Exemplos

O SQL a seguir cria uma linestring de um multiponto.

SELECT ST_AsEWKT(ST_LineFromMultiPoint(ST_GeomFromText('MULTIPOINT(0 0,10 0,10 10,5 5,0 5)',4326)));
st_asewkt --------------------------------------------- SRID=4326;LINESTRING(0 0,10 0,10 10,5 5,0 5)