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 n-ésimo elemento contado desde 1 del valor de entrada GEOMETRY como un valor GEOMETRY.
Syntax
st_geometryn ( geoExpr, nExpr )
Arguments
-
geoExpr: UnGEOMETRYvalor. -
nExpr: índice basado en 1 del elemento que se va a recuperar.
Returns
Valor de tipo GEOMETRY, que representa el n-º elemento de la geometría de entrada.
Si la entrada es un punto múltiple, una cadena multilínea, un multipolygon o una colección de geometría, la función devuelve el elemento n-th o devuelve un error si el elemento no existe.
Si la entrada es un punto no vacío, una cadena de líneas o un polígono y el valor del índice es igual a 1, la función devuelve la entrada como un GEOMETRY valor; de lo contrario, devuelve un error.
El valor SRID de la geometría de salida es el mismo que el del valor de entrada.
Tenga en cuenta que los índices menores de 1 no se admiten y producirán un error.
La función devuelve NULL si la entrada es NULL.
Condiciones de error
- Si el elemento del índice n no existe, la función devuelve ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
- Si el índice es menor que 1, la función devuelve ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
- Si la entrada es un punto, una cadena de líneas o un polígono no vacíos y el índice no es igual a 1, la función devuelve ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
Examples
-- Returns the second element of a geometry collection.
> SELECT st_astext(st_geometryn(st_geomfromtext('GEOMETRYCOLLECTION(POINT(4 5),LINESTRING(10 3,24 37,44 85))'), 2));
LINESTRING(10 3,24 37,44 85)
-- Returns the first element of a multipoint.
> SELECT st_astext(st_geometryn(st_geomfromtext('MULTIPOINT((1 2),(3 4),(5 6))'), 1));
POINT(1 2)