ST_PointN - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

ST_PointN

ST_PointN retorna um ponto em uma linestring, conforme especificado por um valor de índice. Os valores de índice negativos são contados de maneira regressiva, começando pelo final da linestring, de modo que -1 seja o último ponto.

A dimensão da geometria retornada é a mesma geometria de entrada.

Sintaxe

ST_PointN(geom, index)

Argumentos

geom

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

índice

Um valor do tipo de dados INTEGER que representa o índice de um ponto em uma linestring.

Tipo de retorno

GEOMETRY de subtipo POINT.

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada está definido como 0.

Se geom ou index for null, será retornado null.

Se index estiver fora do intervalo, será retornado null.

Nulo será retornado se geom estiver vazio.

Se geom não for uma LINESTRING, será retornado null.

Exemplos

O SQL a seguir retorna uma representação de Extended well-known text (EWKT – Texto bem-conhecido estendido) de uma LINESTRING de seis pontos para um objeto GEOMETRY e retorna o ponto do índice 5 da linestring. 

SELECT ST_AsEWKT(ST_PointN(ST_GeomFromText('LINESTRING(0 0,10 0,10 10,5 5,0 5,0 0)',4326), 5));

st_asewkt
-------------
 SRID=4326;POINT(0 5)