st_envelope_agg 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 la envolvente de todas las geometrías de la columna, o NULL si la columna tiene cero filas o contiene solo valores NULL.

Syntax

st_envelope_agg ( geoCol )

Arguments

• geoCol: una columna GEOMETRY.

Returns

Valor de tipo GEOMETRY, que representa la envolvente de todas las geometrías de la columna.

La función devuelve NULL si la columna tiene cero filas o solo NULL contiene valores.

Condiciones de error

• Si la entrada contiene geometrías con valores SRID diferentes, la función devuelve ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns the envelope of multiple geometries.
> SELECT st_astext(st_envelope_agg(st_geomfromtext(*))) FROM (SELECT * FROM VALUES('POINT(-5 -5)'),('MULTIPOINT(1 2,8 8,5 9,-7 -7,EMPTY)'),('MULTILINESTRING(EMPTY,(5 5,9 9),(9 9,15 15))'),('POLYGON((0 0,10 0,10 10,0 10,0 0))'));
  POLYGON((-7 -7,-7 15,15 15,15 -7,-7 -7))
-- Returns NULL for an empty result set.
> SELECT st_envelope_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
  NULL

Funciones relacionadas

• st_envelope Función