Available in versions: Dev (3.18) | Latest (3.17) | 3.16

This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.

ST_Union

Applies to ❌ Open Source Edition   ✅ Express Edition   ✅ Professional Edition   ✅ Enterprise Edition

This function combines a geometry with another. For example:

create.select(stUnion(
  stGeomFromText("POLYGON ((-1 -1, 1 -1, 1 1, -1 1, -1 -1))"),
  stGeomFromText("POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))"),
)).fetch();

The result being, for example

+--------------------------------------------------------------+
| ST_Union                                                     |
+--------------------------------------------------------------+
| POLYGON ((1 -1, -1 -1, -1 1, 0 1, 0 2, 2 2, 2 0, 1 0, 1 -1)) |
+--------------------------------------------------------------+

Or, visually:








Dialect support

This example using jOOQ:

stUnion(geometry1, geometry2)

Translates to the following dialect specific expressions:

-- AURORA_MYSQL, AURORA_POSTGRES, MARIADB, MYSQL, POSTGRES, REDSHIFT
st_union(geometry1, geometry2)

-- COCKROACHDB
(
  SELECT st_union(v)
  FROM (VALUES
    (geometry1),
    (geometry2)
  ) AS t (v)
)

-- ORACLE
sdo_geom.sdo_union(geometry1, geometry2, tol => null)

-- SQLSERVER
geometry1.STUnion(geometry2)

-- ACCESS, ASE, BIGQUERY, DB2, DERBY, EXASOL, FIREBIRD, H2, HANA, HSQLDB, INFORMIX, MEMSQL, SNOWFLAKE, SQLDATAWAREHOUSE, 
-- SQLITE, SYBASE, TERADATA, VERTICA, YUGABYTEDB
/* UNSUPPORTED */

(These are currently generated with jOOQ 3.18, see #10141), or translate your own on our website

Feedback

Do you have any feedback about this page? We'd love to hear it!

The jOOQ Logo