Man nehme eine Datenbanktabelle...
Customers
... und eine Datenbankanfrage wie zB ...
Query q = em.createQuery("select object(o) from Customers as o");
... und bekommt eine Fehlermeldung...
Exception [TOPLINK-8034] (Oracle TopLink Essentials - 2.0 (Build b58g-fcs (09/07/2007))): oracle.toplink.essentials.exceptions.EJBQLException
Exception Description: Error compiling the query [select count(o) from Customers as o]. Unknown abstract schema type [Customers].
... und wundert sich ...
... bis man feststellt, dass das SQL, was man da sieht, kein SQL ist und nicht der Tabellenname, sondern der Entityname - in diesem Fall "customer" - benutzt werden muss.
Wenn das nicht mal intuitiv ist...