我想知道是否可以像这样从 jpa/hibernate 注释创建数据库列描述/注释：
ALTER TABLE tablename CHANGE status status INT(11) NOT NULL COMMENT 'sample description/comment';
这将是很棒的功能，但我在 JPA 规范中找不到任何关于此的内容。
也许我应该使用@Column(columnDefinition="") 属性，但我没有任何线索。
请帮忙
【问题讨论】：
标签： java mysql sql hibernate jpa
我找到了自己问题的答案。
我不确定是否可以？它适用于所有数据库吗？
当然它适用于 mysql。
这是工作代码：
@Column(columnDefinition=" INT(11) NOT NULL COMMENT '0 for no action, 1 for executed, 2 for validated, 3 for aproved'")
private int status;
【讨论】：
@Table 注释，但尚未测试。
表格注释的注释说明已存在。为此，我们必须使用 Hibernate @Table 注解，与 JPA @Table 注解互补。
例如：
@javax.persistence.Table( name = "Cat" )
@org.hibernate.annotations.Table( comment = "Table for cats" )
public class Cat {
...
关于专栏评论： 似乎没有等价物，即使在 Hibernate 5.2 / JPA 2.1 中也是如此。
很久以前（2007 年）就该主题提交了一个问题，但仍未解决：Support @Comment or column attribute on @Table and @Column。自 2012 年以来被遗弃？
我还在 org.hibernate.dialect.Dialect 中发现了评论用法：
/**
* Does this dialect/database support commenting on tables, columns, etc?
*
* @return {@code true} if commenting is supported
*/
public boolean supportsCommentOn() {
return false;
}
/**
* Get the comment into a form supported for table definition.
*
* @param comment The comment to apply
*
* @return The comment fragment
*/
public String getTableComment(String comment) {
return "";
}
/**
* Get the comment into a form supported for column definition.
*
* @param comment The comment to apply
*
* @return The comment fragment
*/
public String getColumnComment(String comment) {
return "";
}
例如 PostgreSQL81Dialect 支持它（supportsCommentOn() 返回 true）。
它允许使用 SQL 命令“COMMENT ON ...”，
就像在 PostgreSQL (https://www.postgresql.org/docs/current/static/sql-comment.html) 中一样。
例如：
COMMENT ON TABLE my_schema.my_table IS 'Employee Information';
COMMENT ON COLUMN my_table.my_column IS 'Employee ID number';
似乎在那里使用：org.hibernate.tool.schema.internal.StandardTableExporter#getSqlCreateStrings
该列的注释是从使用 org.hibernate.mapping.Column#getComment 的 Hibernate 映射中提取的。
最后，如果使用Hibernate Tools和逆向工程，列的注释是从JDBC DatabaseMetaData中提取的，使用org.hibernate.cfg.reveng.BasicColumnProcessor#processBasicColumns。
-> String comment = (String) columnRs.get("REMARKS");
【讨论】：
虽然将域模型映射到关系数据需要 Hibernate 映射，但将此功能扩展到生成数据库架构也不是一个好主意。
这可能适用于一个相对较小的项目，但是当您有一个随着每次 Sprint 迭代而发展的大中型企业应用程序时，您就需要一个数据库架构迁移工具，例如 Flyway。
注释不需要域模型映射，因为它是关系特定的描述。领域模型应该使用 JavaDocs 来记录每个字段的含义（根据特定的领域逻辑要求）。
【讨论】：