st_endpoint Función

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 último punto del valor de entrada GEOGRAPHY o GEOMETRY, si el valor geoespacial de entrada es una línea no vacía.

Syntax

st_endpoint ( geoExpr )

Arguments

• geoExpr: un GEOGRAPHY valor o GEOMETRY que representa una cadena de líneas.

Returns

Valor de tipo GEOGRAPHY o GEOMETRY, que representa el último punto de la cadena de líneas.

El valor SRID del punto de salida es el mismo que el del valor de entrada.

La dimensión del punto de salida es la misma que la de la cadena de línea de entrada.

La función devuelve NULL si la entrada es NULL.

Condiciones de error

• Si el valor de geoExpr no es una cadena de línea, la función devuelve ST_INVALID_ARGUMENT. INVALID_TYPE.
• Si el valor de geoExpr es una cadena de línea vacía, la función devuelve ST_INVALID_ARGUMENT. EMPTY_LINESTRING.

Examples

-- Returns the endpoint of a linestring geometry.
> SELECT st_asewkt(st_endpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
  SRID=4326;POINT(5 6)
-- Returns the endpoint of a linestring geography with Z and M coordinates.
> SELECT st_asewkt(st_endpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
  SRID=4326;POINT ZM (5 6 7 8)

Funciones relacionadas

• st_startpoint Función