EclipseLink/UserGuide/JPA/Advanced JPA Development/NoSQL/Querying

---

This page is now obsolete.

For current information, please see "Using EclipseLink with NoSQL Databases in the EclipseLink Solutions Guide: http://www.eclipse.org/eclipselink/documentation/latest/solutions/nonrelational_db.htm

---

EclipseLink JPA

• EclipseLink Destinations:
• Documentation
• FAQ
• Examples
• Development

Native API

• EISInteraction
• MappedInteraction
• XMLInteraction
• DescriptorQueryManager

Querying

Querying in NoSQL is dependent on the NoSQL platform. Some NoSQL data-sources may support dynamic querying through their own query language, others may not support querying at all.

JPQL and Criteria

EclipseLink does its best to support as much of JPQL and the Criteria API on a NoSQL platform as possible. Almost all NoSQL platforms allow querying by Id, so find() can be used to look-up objects by Id. Most NoSQL platforms also allow a find everything operation, this allows EclipseLink to support JPQL and Criteria queries that are by Id, or have no where clause.

For example:

SELECT o FROM ORDER o

SELECT o FROM ORDER o WHERE o.id = :id

MongoDB - JPQL and Criteria are supported with some restrictions. Joins, sub-selects, group by and certain database functions are not supported.

Oracle NoSQL - find() and JPQL and Criteria by Id or with no WHERE clause are supported.

MongoDB JPQL examples

Query query = em.createQuery("Select o from Order o where o.totalCost > 1000");
List<Order> orders = query.getResultList();
 
Query query = em.createQuery("Select o from Order o where o.description like 'Pinball%'");
List<Order> orders = query.getResultList();
 
Query query = em.createQuery("Select o from Order o join o.orderLines l where l.description = :desc");
query.setParameter("desc", "shipping");
List<Order> orders = query.getResultList();
 
Query query = em.createQuery("Select o.totalCost from Order o");
List<BigDecimal> orders = query.getResultList();

Native Queries

Native SQL queries are not supported with NoSQL. Some NoSQL platforms may offer their own native query language, EclipseLink will allow JPA native queries using this language.

MongoDB - JPA native queries use the MongoDB native command language.

MongoDB native query example

Query query = em.createNativeQuery("db.ORDER.findOne({\"_id\":\"" + oid + "\"})", Order.class);
Order order = (Order)query.getSingleResult();

Interaction Queries

Internally EclipseLink uses instances of EISInteraction to execute queries. There are two main EISInteraction subclasses, MappedInteraction and XMLInteraction. Interactions are the NoSQL equivalent to SQLCall and StoredProcedureCall in the EclipseLink native API for relational databases. Interactions can contain content and properties to pass to the NoSQL adapter to execute a specific operation. Interactions can be used on EclipseLink native API DatabaseQuery, or in mapping or DescriptorQueryManager operations.

The DescriptorQueryManager contains operations for readObject, readAll, insert, update, and delete. An interaction can be defined for any of these operations to customize or define how the operation should execute. This can be done using the EclipseLink native API through a DescriptorCustomizer.

Version: 2.4.0 DRAFT
Other versions...

Mappings	NoSQL	Transactions
EclipseLink Home JPA User Guide: Table of Contents, Search
How to contribute to this guide...