{"record":{"id":"4cc6ffc7d0cbd690","repo":"hibernate/hibernate-orm","slug":"entity-mapping-does-not-support-primary-tablerefer-4cc6ff","errorCode":null,"errorMessage":"Entity mapping does not support primary TableReference join creation [{className} : {entityName}]","messagePattern":"Entity mapping does not support primary TableReference join creation \\[(.+?) : (.+?)\\]","errorType":"exception","errorClass":"UnsupportedMappingException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/metamodel/mapping/EntityMappingType.java","lineNumber":623,"sourceCode":"\t\t\t\tcreationState\n\t\t);\n\t}\n\n\tdefault TableReference createPrimaryTableReference(\n\t\t\tSqlAliasBase sqlAliasBase,\n\t\t\tSqlAstCreationState creationState) {\n\t\tthrow new UnsupportedMappingException(\n\t\t\t\t\"Entity mapping does not support primary TableReference creation [\" +\n\t\t\t\t\t\tgetClass().getName() + \" : \" + getEntityName() + \"]\"\n\t\t);\n\t}\n\n\tdefault TableReferenceJoin createTableReferenceJoin(\n\t\t\tString joinTableExpression,\n\t\t\tSqlAliasBase sqlAliasBase,\n\t\t\tTableReference lhs,\n\t\t\tSqlAstCreationState creationState) {\n\t\tthrow new UnsupportedMappingException(\n\t\t\t\t\"Entity mapping does not support primary TableReference join creation [\" +\n\t\t\t\t\t\tgetClass().getName() + \" : \" + getEntityName() + \"]\"\n\t\t);\n\t}\n\n\t@Override\n\tdefault JavaType<?> getMappedJavaType() {\n\t\treturn getEntityPersister().getMappedJavaType();\n\t}\n\n\t@Override\n\tdefault int getNumberOfFetchables() {\n\t\treturn getEntityPersister().getNumberOfFetchables();\n\t}\n\n\t@Override\n\tdefault Fetchable getFetchable(int position) {\n\t\treturn getEntityPersister().getFetchable( position );","sourceCodeStart":605,"sourceCodeEnd":641,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/EntityMappingType.java#L605-L641","documentation":"Error \"Entity mapping does not support primary TableReference join creation [{className} : {entityName}]\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown when SQL generation requests a primary table reference join from an entity mapping that does not support table group joins.","commonSituations":"See trigger scenarios.","solutions":["Avoid join fetches or query shapes that require a primary table join for this entity mapping, or report the limitation to Hibernate."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}