@UniqueConstraint y @Column (único = verdadero) en la anotación de hibernación

104

¿Cuál es la diferencia entre @UniqueConstraint y @Column (único = verdadero) ?

Por ejemplo:

@Table(
   name = "product_serial_group_mask", 
   uniqueConstraints = {@UniqueConstraint(columnNames = {"mask", "group"})}
)

Y

@Column(unique = true)
@ManyToOne(optional = false, fetch = FetchType.EAGER)
private ProductSerialMask mask;

@Column(unique = true)
@ManyToOne(optional = false, fetch = FetchType.EAGER)
private Group group;

java hibernate hibernate-annotations

— navid_gh
fuente

2

Nota: Con Hibernate 5.4, cuando agregué unique=true, el actualizador automático de esquemas no agregó el índice. @UniqueConstraintlo hizo aparecer. Podría ser un error.

— Ondra Žižka

147

Como se dijo antes, @Column(unique = true)es un atajo para UniqueConstraintcuando es un solo campo.

Por el ejemplo que dio, hay una gran diferencia entre ambos.

@Column(unique = true)
@ManyToOne(optional = false, fetch = FetchType.EAGER)
private ProductSerialMask mask;

@Column(unique = true)
@ManyToOne(optional = false, fetch = FetchType.EAGER)
private Group group;

Este código implica que ambos masky grouptienen que ser únicos, pero por separado. Eso significa que si, por ejemplo, tiene un registro con mask.id = 1 e intenta insertar otro registro con mask.id = 1 , obtendrá un error, porque esa columna debe tener valores únicos. Lo mismo se aplica al grupo.

Por otra parte,

@Table(
   name = "product_serial_group_mask", 
   uniqueConstraints = {@UniqueConstraint(columnNames = {"mask", "group"})}
)

Implica que los valores de máscara + grupo combinados deben ser únicos. Eso significa que puede tener, por ejemplo, un registro con mask.id = 1 y group.id = 1 , y si intenta insertar otro registro con mask.id = 1 y group.id = 2 , se insertará con éxito, mientras que en el primer caso no lo haría.

Si desea que tanto la máscara como el grupo sean únicos por separado y para eso a nivel de clase, tendrá que escribir el código de la siguiente manera:

@Table(
        name = "product_serial_group_mask",
        uniqueConstraints = {
                @UniqueConstraint(columnNames = "mask"),
                @UniqueConstraint(columnNames = "group")
        }
)

Esto tiene el mismo efecto que el primer bloque de código.

— Glauber Néspoli
fuente

Una vez que se crea la restricción única, ¿puedo hacer referencia a la restricción por nombre en mi repositorio JPA para consultar sobre eso?

— jDub9

@ jDub9 No puede consultar un índice. Puede consultar la máscara y las columnas de grupo, en una consulta, y usará ese índice para un procesamiento más rápido (si tiene suerte), pero no puede simplemente consultar un índice.

— Dalibor Filus

Sin embargo, tenga en cuenta que columnNames debe ser nombres reales en la base de datos. Debería serlo mask_idy group_idsi usa la estrategia de nomenclatura predeterminada.

— vitro

27

De la documentación de Java EE:

public abstract boolean unique
(Opcional) Si la propiedad es una clave única. Este es un atajo para la anotación UniqueConstraint en el nivel de tabla y es útil cuando la restricción de clave única es solo un campo. Esta restricción se aplica además de cualquier restricción que conlleve la asignación de clave primaria y a las restricciones especificadas en el nivel de la tabla.

Ver documento

— Booz
fuente

así que cuando uso este código: @Column (único = verdadero) @ManyToOne (opcional = falso, fetch = FetchType.EAGER) máscara de ProductSerialMask privada; @Column (único = verdadero) @ManyToOne (opcional = falso, fetch = FetchType.EAGER) grupo de grupo privado; Tengo dos índices, pero cuando lo uso de otra manera, ¿tengo un índice que es una combinación de dos columnas?

— navid_gh

22

Además de la respuesta de Booz ...

@UniqueConstraintle permite nombrar la restricción , mientras @Column(unique = true)genera un nombre aleatorio (por ejemplo UK_3u5h7y36qqa13y3mauc5xxayq).

A veces puede resultar útil saber con qué tabla está asociada una restricción. P.ej:

@Table(
   name = "product_serial_group_mask", 
   uniqueConstraints = {
      @UniqueConstraint(
          columnNames = {"mask", "group"},
          name="uk_product_serial_group_mask"
      )
   }
)

— vegemite4me
fuente

5

Además de las respuestas de @ Boaz y @ vegemite4me ...

Al implementarlo ImplicitNamingStrategy, puede crear reglas para nombrar automáticamente las restricciones. Tenga en cuenta que agrega su estrategia de nomenclatura metadataBuilderdurante la inicialización de Hibernate:

metadataBuilder.applyImplicitNamingStrategy(new MyImplicitNamingStrategy());

Funciona para @UniqueConstraint, pero no para @Column(unique = true), que siempre genera un nombre aleatorio (por ejemplo, UK_3u5h7y36qqa13y3mauc5xxayq).

Hay un informe de error para resolver este problema, así que si puede, vote allí para implementarlo. Aquí: https://hibernate.atlassian.net/browse/HHH-11586

Gracias.

— MarcG
fuente