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

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.

ARRAY_PREPEND (|| operator)

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

The ARRAY_PREPEND function allows for concatenating an element to the beginning of an array (see also ARRAY_APPEND and ARRAY_CONCAT):

SELECT 1 || ARRAY[2, 3]
create.select(arrayPrepend(1, array(2, 3))).fetch();

The result would look like this:

+--------------.+
| array_prepend |
+---------------+
| [1, 2, 3]     |
+---------------+

Dialect support

This example using jOOQ:

arrayPrepend(1, array(2, 3))

Translates to the following dialect specific expressions:

Aurora Postgres, CockroachDB, DuckDB, Postgres, YugabyteDB

array_prepend(
  1,
  ARRAY[2, 3]
)

BigQuery, H2, HSQLDB, Trino

(ARRAY[1] || ARRAY[2, 3])

ClickHouse

arrayPushFront(
  ARRAY(2, 3),
  1
)

ASE, Access, Aurora MySQL, DB2, Derby, Exasol, Firebird, Hana, Informix, MariaDB, MemSQL, MySQL, Oracle, Redshift, SQLDataWarehouse, SQLServer, SQLite, Snowflake, Sybase, Teradata, Vertica

/* UNSUPPORTED */
Generated with jOOQ 3.20. Translate your own SQL on our website

Feedback

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

The jOOQ Logo