Partilhar via


st_envelope_agg Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

Este recurso está no Public Preview.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Retorna o envelope de todas as geometrias presentes na coluna, ou NULL caso a coluna tenha zero linhas, ou contenha apenas valores NULL.

Syntax

st_envelope_agg ( geoCol )

Arguments

  • geoCol: Uma GEOMETRY coluna.

Returns

Um valor do tipo GEOMETRY, que representa o envelope de todas as geometrias na coluna.

A função retorna NULL se a coluna tiver zero linhas ou contiver apenas NULL valores.

Condições de erro

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