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 )
Databricks
array_prepend( 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.21. Support in older jOOQ versions may differ. Translate your own SQL on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!