ROOT directive
Applies to ❌ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
The ROOT
directive allows for wrapping the XML document fragment in a root element.
Consider the following query
SELECT id, title FROM book ORDER BY id FOR XML RAW, ROOT ('result')
create.select(BOOK.ID, BOOK.TITLE) .from(BOOK) .orderBy(BOOK.ID) .forXML().raw().root("result") .fetch();
This query produces a document like this:
<result> <row ID="1" TITLE="1984"/> <row ID="2" TITLE="Animal Farm"/> <row ID="3" TITLE="O Alquimista"/> <row ID="4" TITLE="Brida"/> </result>
Dialect support
This example using jOOQ:
select(BOOK.ID).from(BOOK).orderBy(BOOK.ID).forXML().raw().root("result")
Translates to the following dialect specific expressions:
DB2, Oracle, Postgres
SELECT xmlelement( NAME result, xmlagg(xmlelement( NAME row, xmlattributes(t.ID AS ID) )) ) FROM ( SELECT BOOK.ID FROM BOOK ORDER BY BOOK.ID ) t
SQLServer
SELECT ( SELECT BOOK.ID FROM BOOK ORDER BY BOOK.ID FOR XML RAW, ROOT ('result') )
Teradata
SELECT xmlelement( NAME result, xmlagg(xmlelement( NAME row, xmlattributes(t.ID AS ID) )) ) FROM ( SELECT * FROM ( SELECT TOP 999999999999999999 BOOK.ID FROM BOOK ORDER BY BOOK.ID ) x ) t
ASE, Access, Aurora MySQL, Aurora Postgres, BigQuery, ClickHouse, CockroachDB, Databricks, Derby, DuckDB, Exasol, Firebird, H2, HSQLDB, Hana, Informix, MariaDB, MemSQL, MySQL, Redshift, SQLDataWarehouse, SQLite, Snowflake, Sybase, Trino, Vertica, YugabyteDB
/* 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!