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

ST_Difference

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

This function subtracts a geometry from another. For example:

create.select(stDifference(
  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_Difference                                      |
+----------------------------------------------------+
| POLYGON ((-1 1, 0 1, 0 0, 1 0, 1 -1, -1 -1, -1 1)) |
+----------------------------------------------------+

Or, visually:






Dialect support

This example using jOOQ:

stDifference(geometry1, geometry2)

Translates to the following dialect specific expressions:

Aurora MySQL, Aurora Postgres, CockroachDB, MariaDB, MySQL, Postgres, Redshift, Snowflake

st_difference(geometry1, geometry2)

Oracle

sdo_geom.sdo_difference(geometry1, geometry2, tol => null)

SQLServer

geometry1.STDifference(geometry2)

ASE, Access, BigQuery, ClickHouse, DB2, Derby, DuckDB, Exasol, Firebird, H2, HSQLDB, Hana, Informix, MemSQL, SQLDataWarehouse, SQLite, Sybase, Teradata, Trino, Vertica, YugabyteDB

/* UNSUPPORTED */

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

References to this page

Feedback

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

The jOOQ Logo