@UniqueConstraint e @Column (unique = true) na anotação de hibernação

104

Qual é a diferença entre @UniqueConstraint e @Column (unique = true) ?

Por exemplo:

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

E

@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
fonte

2

Nota: Com o Hibernate 5.4, quando adicionei unique=true, o índice não foi adicionado pelo atualizador automático do esquema. @UniqueConstraintfez parecer. Pode ser um bug.

— Ondra Žižka

147

Como disse antes, @Column(unique = true)é um atalho paraUniqueConstraint quando é apenas um campo.

Pelo exemplo que você deu, há uma grande diferença entre os dois.

@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 maske groupdevem ser únicos, mas separadamente. Isso significa que se, por exemplo, você tiver um registro com mask.id = 1 e tentar inserir outro registro com mask.id = 1 , receberá um erro, porque essa coluna deve ter valores únicos. O mesmo se aplica ao grupo.

Por outro lado,

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

Implica que os valores de máscara + grupo combinados devem ser únicos. Isso significa que você pode ter, por exemplo, um registro com mask.id = 1 e group.id = 1 , e se você tentar inserir outro registro com mask.id = 1 e group.id = 2 , ele será inserido com sucesso, enquanto no primeiro caso não o faria.

Se você quiser que a máscara e o grupo sejam únicos separadamente e no nível da classe, você terá que escrever o código da seguinte forma:

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

Isso tem o mesmo efeito que o primeiro bloco de código.

— Glauber Néspoli
fonte

Depois que a restrição exclusiva é criada, posso fazer referência à restrição por nome em meu Repositório JPA para consultá-la?

— jDub9

@ jDub9 Você não pode consultar um índice. Você pode consultar as colunas de máscara e grupo, em uma consulta, e ele usará esse índice para processamento mais rápido (se você tiver sorte), mas você não pode simplesmente consultar um índice.

— Dalibor Filus

Tenha cuidado, porém, que columnNames deve ser nomes reais no banco de dados. Deve ser mask_ide group_idse você usar a estratégia de nomenclatura padrão.

— vitro

27

Da documentação do Java EE:

public abstract boolean unique
(Opcional) Se a propriedade é uma chave exclusiva. Este é um atalho para a anotação UniqueConstraint no nível da tabela e é útil quando a restrição de chave exclusiva é apenas um único campo. Essa restrição se aplica além de qualquer restrição acarretada pelo mapeamento de chave primária e às restrições especificadas no nível da tabela.

Veja doc

— Boaz
fonte

então, quando eu uso este código: @Column (unique = true) @ManyToOne (optional = false, fetch = FetchType.EAGER) private ProductSerialMask mask; @Column (unique = true) @ManyToOne (opcional = false, fetch = FetchType.EAGER) Grupo privado do grupo; Tenho dois índices mas quando uso de outra forma tenho um índice que é combinação de duas colunas?

— navid_gh

22

Além da resposta de Boaz ....

@UniqueConstraintpermite nomear a restrição , enquanto @Column(unique = true)gera um nome aleatório (por exemplo UK_3u5h7y36qqa13y3mauc5xxayq).

Às vezes, pode ser útil saber a qual tabela uma restrição está associada. Por exemplo:

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

— vegemite4me
fonte

5

Além das respostas de @ Boaz e @ vegemite4me ....

Ao implementar, ImplicitNamingStrategyvocê pode criar regras para nomear automaticamente as restrições. Observe que você adiciona sua estratégia de nomenclatura ao metadataBuilderdurante a inicialização do Hibernate:

metadataBuilder.applyImplicitNamingStrategy(new MyImplicitNamingStrategy());

Ele funciona para @UniqueConstraint, mas não para @Column(unique = true), que sempre gera um nome aleatório (por exemplo, UK_3u5h7y36qqa13y3mauc5xxayq).

Há um relatório de bug para resolver esse problema, então se você puder, vote aqui para que isso seja implementado. Aqui: https://hibernate.atlassian.net/browse/HHH-11586

Obrigado.

— MarcG
fonte