Available in versions: Dev (3.20) | Latest (3.19) | 3.18 | 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.


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

This function returns the N-th geometry (1-based) from a geometry that contains multiple nested geometries. For example:

create.select(stGeometryN(stGeomFromText("MULTIPOINT ((-1 -1), (1 -1), (1 1), (-1 1))"), 2)).fetch();

The result being, for example

| ST_GeometryN |
| POINT (1 -1) |

Or, visually:

To get the total number of geometries, use ST_NumGeometries.

Dialect support

This example using jOOQ:

stGeometryN(geometry, 2)

Translates to the following dialect specific expressions:

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

st_geometryn(geometry, 2)



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


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

References to this page


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

The jOOQ Logo