Nota
L'accés a aquesta pàgina requereix autorització. Pots provar d'iniciar sessió o canviar de directori.
L'accés a aquesta pàgina requereix autorització. Pots provar de canviar directoris.
Se aplica a:
Databricks SQL Databricks Runtime 17.1 y versiones posteriores
Important
Esta característica está en versión preliminar pública.
Nota:
Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.
Devuelve el punto n-ésimo del linestring de entrada GEOGRAPHY o del valor GEOMETRY.
Syntax
st_pointn ( geoExpr, indexExpr )
Arguments
-
geoExpr: unGEOGRAPHYvalor oGEOMETRYque representa una cadena de líneas. -
indexExprINTEGER: valor que indica la posición basada en 1 en la cadena de líneas del punto que se debe devolver.
Returns
Valor de tipo GEOGRAPHY o GEOMETRY, que representa el punto de la indexExpr posición del linestring de entrada.
El valor SRID del punto de salida es igual al de la entrada GEOGRAPHY o GEOMETRY.
La dimensión del punto de salida es la misma que la del valor de entrada GEOGRAPHY o GEOMETRY.
La función devuelve NULL si alguna de las entradas es NULL.
Condiciones de error
- Si el valor de
geoExprno es una cadena de línea, la función devuelve ST_INVALID_ARGUMENT. INVALID_TYPE. - Si el valor de
geoExpres una cadena de línea vacía, la función devuelve ST_INVALID_ARGUMENT. EMPTY_LINESTRING. - Si el valor absoluto del valor de
indexExpres 0 o mayor que el número de puntos de la cadena de líneas, la función devuelve ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
Examples
-- Returns the third point of the linestring counting from the left.
> SELECT st_astext(st_pointn(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 3));
POINT(5 6)
-- Returns the third point of the linestring counting from the right.
> SELECT st_astext(st_pointn(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -3));
POINT(1 2)