ST_POINTN (Lakehouse v1)

Retorna um Point em um índice especificado de uma LineString.

Sintaxe SQL

ST_POINTN(<geometry>, <index>)

Argumentos

Argumentos	Descrição
<geometry>	O argumento deve ser uma expressão do tipo GEOMETRY que represente uma LineString.
<index>	O índice do Point a retornar.

Nota

O índice começa em 1, e um índice negativo é usado como deslocamento a partir do fim da LineString. Se o índice estiver fora dos limites, a função retorna um erro.

Tipo de retorno

Geometry.

Exemplos de SQL

SELECT
  ST_POINTN(
    ST_GEOMETRYFROMWKT(
      'LINESTRING(1 1, 2 2, 3 3, 4 4)'
    ),
    1
  ) AS pipeline_pointn;

┌─────────────────┐
│ pipeline_pointn │
├─────────────────┤
│ POINT(1 1)      │
└─────────────────┘

SELECT
  ST_POINTN(
    ST_GEOMETRYFROMWKT(
      'LINESTRING(1 1, 2 2, 3 3, 4 4)'
    ),
    -2
  ) AS pipeline_pointn;

┌─────────────────┐
│ pipeline_pointn │
├─────────────────┤
│ POINT(3 3)      │
└─────────────────┘