Specifies a table or tables that hold state mapped by the annotated entity or collection.

If Hibernate is not aware that a certain table holds state mapped by an entity class or collection, then modifications might not be automatically synchronized with the database before a query is executed against that table, and the query might return stale data.

Ordinarily, Hibernate knows the tables containing the state of an entity or collection. This annotation might be necessary if:

• an entity or collection maps a database view,
• an entity or collection is persisted using handwritten SQL, that is, using @SQLSelect and friends, or
• an entity is mapped using @Subselect.

By default, the table names specified by this annotation are interpreted as logical names, and are processed by org.hibernate.boot.model.naming.PhysicalNamingStrategy#toPhysicalTableName. But if logical=false, the table names will be treated as physical names, and will not be processed by the naming strategy.