Jakarta Persistence (JPA) Annotation Type

jakarta.persistence.Column

Implemented Interfaces:
Annotation
Target:
Method, Field
Specifies the column mapped by the annotated persistent property or field.

If no Column annotation is explicitly specified, the default values apply.

Example 1: 

 @Column(name = "DESC", nullable = false, length = 512)
 public String getDescription() { return description; }

Example 2: 

 @Column(name = "DESC",
         columnDefinition = "CLOB NOT NULL",
         table = "EMP_DETAIL")
 @Lob
 public String getDescription() { return description; }

Example 3: 

 @Column(name = "ORDER_COST", updatable = false, precision = 12, scale = 2)
 public BigDecimal getCost() { return cost; }

Portable applications which make use of schema generation should explicitly specify the precision and scale of columns of type numeric or decimal.

Since:
Jakarta Persistence (JPA) 1.0

Annotation Elements

String name
(Optional) The name of the column.
Defaults to the property or field name.
Default:
""
Since:
Jakarta Persistence (JPA) 1.0
boolean unique
(Optional) Whether the column is a unique key.
This is a shortcut for the UniqueConstraint annotation at the table level and is useful for when the unique key constraint corresponds to only a single column. This constraint applies in addition to any constraint entailed by the primary key mapping and to constraints specified at the table level.
Default:
false
Since:
Jakarta Persistence (JPA) 1.0
boolean nullable
(Optional) Whether the database column is nullable.
Default:
true
Since:
Jakarta Persistence (JPA) 1.0
boolean insertable
(Optional) Whether the column is included in SQL INSERT statements generated by the persistence provider.
Default:
true
Since:
Jakarta Persistence (JPA) 1.0
boolean updatable
(Optional) Whether the column is included in SQL UPDATE statements generated by the persistence provider.
Default:
true
Since:
Jakarta Persistence (JPA) 1.0
String columnDefinition
(Optional) The SQL fragment that is used when generating the DDL for the column.

Defaults to the generated SQL to create a column of the inferred type.

The specified DDL must be written in the native SQL dialect of the target database, and is not portable across databases.

Default:
""
Since:
Jakarta Persistence (JPA) 1.0
String options
(Optional) A SQL fragment appended to the generated DDL which declares this column.
May not be used in conjunction with columnDefinition.

The specified DDL must be written in the native SQL dialect of the target database, and is not portable across databases.

Default:
""
Since:
Jakarta Persistence (JPA) 3.2
String table
(Optional) The name of the table that contains the column.
If absent the column is assumed to be in the primary table.
Default:
""
Since:
Jakarta Persistence (JPA) 1.0
int length
(Optional) The column length.

Applies only to columns whose type is parameterized by length, for example, varchar or varbinary types.

Default:
255
Since:
Jakarta Persistence (JPA) 1.0
int precision
(Optional) The precision for a column of SQL type decimal or numeric, or of similar database-native type.

Applies only to columns of exact numeric type.

The default value 0 indicates that a provider-determined precision should be inferred.

Default:
0
Since:
Jakarta Persistence (JPA) 1.0
int scale
(Optional) The scale for a column of SQL type decimal or numeric, or of similar database-native type.

Applies only to columns of exact numeric type.

The default value 0 indicates that a provider-determined scale should be inferred.

Default:
0
Since:
Jakarta Persistence (JPA) 1.0
int secondPrecision
(Optional) The number of decimal digits to use for storing fractional seconds in a SQL time or timestamp column.

Applies only to columns of time or timestamp type.

The default value -1 indicates that fractional seconds should not be stored in a time column, or that the maximum number of digits supported by the database and JDBC driver should be stored in a timestamp column.

Default:
-1
Since:
Jakarta Persistence (JPA) 3.2
CheckConstraint[] check
(Optional) Check constraints to be applied to the column.
These are only used if table generation is in effect.
Default:
{}
Since:
Jakarta Persistence (JPA) 3.2
String comment
(Optional) A comment to be applied to the column.
This is only used if table generation is in effect.
Default:
""
Since:
Jakarta Persistence (JPA) 3.2

Additional JDK methods inherited from java.lang.annotation.Annotation

annotationType(), equals(Object), hashCode(), toString()