fungsi st_union_agg

Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 17.1 ke atas

Important

Fitur ini ada di Pratinjau Publik.

Nota

Fitur ini tidak tersedia di gudang Databricks SQL Classic. Untuk mempelajari selengkapnya tentang gudang Databricks SQL, lihat Jenis gudang SQL.

Mengembalikan gabungan titik per titik dari semua geometri dalam kolom, atau NULL jika kolom tidak memiliki baris, atau hanya berisi nilai NULL.

Syntax

st_union_agg ( geoCol )

Arguments

  • geoCol: Kolom jenis GEOMETRY, mewakili objek geometri.

Returns

Nilai bertipe GEOMETRY, mewakili penggabungan secara titik-demi-titik dari nilai GEOMETRY dalam kolom.

Keluaran GEOMETRY selalu dua dimensi.

Fungsi mengembalikan NULL jika kolom memiliki baris nol atau hanya NULL berisi nilai.

Kondisi kesalahan

  • Jika dua GEOMETRY nilai dalam kolom input memiliki nilai SRID yang berbeda, fungsi akan mengembalikan ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns union of multiple geometries from column.
> SELECT st_astext(st_union_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))'));
  GEOMETRYCOLLECTION(MULTIPOINT((-7 -7),(-5 -5)),LINESTRING(10 10,15 15),POLYGON((0 0,10 0,10 10,0 10,0 0)))
-- Returns NULL for empty result set.
> SELECT st_union_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
  NULL