As explained in this Hibernate forum thread, it's not always obvious that depending on the underlying RDBMS capabilities, the user must choose either catalog or schema when mapping JPA attributes to database identifiers.

This issue aims to explain the difference based on the most popular relational database systems.