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.
JSON array element access with -> or ->>
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
JSON array elements can be accessed by (zero based) index as follows:
SELECT '[1,2,3]'::json->1
create.select(jsonGetElement(json("[1,2,3]"), 1))
.fetch();
The result would look like this:
+------------------+ | json_get_element | +------------------+ | 2 | +------------------+
The API is PostgreSQL inspired, and as such, there are two ways of accessing elements:
-
->or withjsonGetElement()/jsonbGetElement(): To produce aorg.jooq.JSONororg.jooq.JSONBvalue -
->>or withjsonGetElementAsText()/jsonbGetElementAsText(): To produce ajava.lang.Stringvalue
Dialect support
This example using jOOQ:
jsonGetElement(json("[1,2,3]"), 1)
Translates to the following dialect specific expressions:
Aurora Postgres, CockroachDB, Postgres, YugabyteDB
(CAST('[1,2,3]' AS json)->1)
BigQuery
json_query(
'[1,2,3]',
('$[' || CAST(1 AS string) || ']')
)
ClickHouse
JSONExtractRaw( '[1,2,3]', (1 + 1) )
DB2
json_query(
'[1,2,3]',
('$.' || CAST(1 AS varchar(3998)))
)
DuckDB, SQLite
('[1,2,3]'->1)
MariaDB, MySQL
json_extract(
'[1,2,3]',
concat(
'$[',
CAST(1 AS char),
']'
)
)
Oracle
json_query('[1,2,3]', '$[1]')
Snowflake
get(parse_json('[1,2,3]'), 1)
Trino
json_extract(
json_parse('[1,2,3]'),
('$[' || CAST(1 AS varchar) || ']')
)
ASE, Access, Aurora MySQL, Databricks, Derby, Exasol, Firebird, H2, HSQLDB, Hana, Informix, MemSQL, Redshift, SQLDataWarehouse, SQLServer, 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!