JPA @SequenceGenerator 注解如何工作

Question

我正在学习 JPA，并对 @SequenceGenerator 注释感到困惑。

据我了解，它会自动为实体的数字标识字段/属性分配一个值。

Q1. 这个序列生成器是利用数据库不断增加的数值生成能力还是自己生成数字？

Q2. 如果 JPA 使用数据库自​​动增量功能，那么它是否可以与没有自动增量功能的数据存储一起使用？

Q3. 如果 JPA 自己生成数值，那么 JPA 实现如何知道接下来要生成哪个值？它是否首先查询数据库以查看最后存储的值以生成值（最后一个 + 1）？

---

Q4。还请说明 @SequenceGenerator 注释的 sequenceName 和 allocationSize 属性。

Answer 1

sequenceName 是数据库中序列的名称。这是指定数据库中已存在的序列的方式。如果您采用此路线，则必须指定 allocationSize，该值需要与数据库序列用作其“自动增量”的值相同。

用法：

@GeneratedValue(generator="my_seq")
@SequenceGenerator(name="my_seq",sequenceName="MY_SEQ", allocationSize=1)

如果您愿意，您可以让它为您创建一个序列。但要做到这一点，您必须使用 SchemaGeneration 来创建它。为此，请使用：

@GeneratedValue(strategy=GenerationType.SEQUENCE)

此外，您还可以使用自动生成功能，它将使用表来生成 ID。使用此功能时，您还必须在某个时候使用 SchemaGeneration，以便可以创建生成器表。为此，请使用：

@GeneratedValue(strategy=GenerationType.AUTO)

Answer 2

现在，回到你的问题：

Q1。该序列生成器是否利用数据库的递增
数值生成能力或生成其上的数字
自己的？

通过在@GenerateValue 注释上使用GenerationType.SEQUENCE 策略，JPA 提供程序将尝试使用支持此功能的底层数据库（例如Oracle 、SQL Server、PostgreSQL、MariaDB）。

如果您使用不支持数据库序列对象的 MySQL，那么 Hibernate 将转而使用 GenerationType.TABLE，这是不可取的，因为 TABLE 生成的性能很差。

因此，不要对 MySQL 使用 GenerationType.SEQUENCE 策略。

第二季度。如果JPA使用数据库自​​增功能，那么它可以工作吗
数据存储没有自动增量功能？

当您说数据库自动增量功能时，我假设您正在谈论GenerationType.IDENTITY。

要使用 AUTO_INCRMENT 或 IDENTITY 列，您需要在 @GenerateValue 注释上使用 GenerationType.IDENTITY 策略。

第三季度。如果JPA自己生成数值，那么JPA如何生成数值
实现知道接下来要生成哪个值？是否咨询
数据库首先查看最后存储的值，以便
生成值（最后+1）？

JPA 提供程序自行生成值的唯一时间是当您使用基于序列的优化器时，例如：

• hi/lo
• 池化或池化-lo

这些优化器可以减少数据库序列调用的数量，因此它们可以增加使用单个数据库序列调用可以生成的标识符值的数量。

为了避免 Hibernate 标识符优化器和其他第 3 方客户端之间的冲突，您应该使用 pooled 或 pooled-lo 而不是 hi/lo。即使您使用的是设计为使用 hi/lo 的旧应用程序，您也可以迁移到pooled 或 pooled-lo 优化器。

第四季度。另请说明 sequenceName 和 allocationSize
@SequenceGenerator 注释的属性。

sequenceName 属性定义用于生成标识符值的数据库序列对象。它是您使用 CREATE SEQUENCE DDL 语句创建的对象。

因此，如果您提供此映射：

@Id
@GeneratedValue(
    strategy = GenerationType.SEQUENCE,
    generator = "seq_post"
)
@SequenceGenerator(
    name = "seq_post"
)
private Long id;

Hibernate 将使用 seq_post 数据库对象来生成标识符值：

SELECT nextval('hibernate_sequence')

allocationSize 定义标识符值乘数，并且如果您提供如果值大于 1，那么 Hibernate 将使用池化优化器来减少数据库序列调用的数量。

因此，如果您提供此映射：

@Id
@GeneratedValue(
    strategy = GenerationType.SEQUENCE,
    generator = "seq_post"
)
@SequenceGenerator(
    name = "seq_post",
    allocationSize = 5
)
private Long id;

那么，当您持久化 5 个实体时：

for (int i = 1; i <= 5; i++) {
    entityManager.persist(
        new Post().setTitle(
            String.format(
                "High-Performance Java Persistence, Part %d",
                i
            )
        )
    );
}

将仅执行 2 个数据库序列调用，而不是 5 个：

SELECT nextval('hibernate_sequence')
SELECT nextval('hibernate_sequence')
 
INSERT INTO post (title, id)
VALUES ('High-Performance Java Persistence, Part 1', 1)
 
INSERT INTO post (title, id)
VALUES ('High-Performance Java Persistence, Part 2', 2)
 
INSERT INTO post (title, id)
VALUES ('High-Performance Java Persistence, Part 3', 3)
 
INSERT INTO post (title, id)
VALUES ('High-Performance Java Persistence, Part 4', 4)
 
INSERT INTO post (title, id)
VALUES ('High-Performance Java Persistence, Part 5', 5)

Answer 3

尽管这个问题很老了，而且我是因为自己的 JPA 2.0 和 Oracle 序列问题而偶然发现的。

想分享我对一些事情的研究 -

GenerationType.SEQUENCE 的 @SequenceGenerator(allocationSize) 和数据库序列定义中的 INCRMENT BY 之间的关系

确保将@SequenceGenerator(allocationSize)设置为与数据库序列定义中的INCRMENT BY相同的值，以避免出现问题（这同样适用于初始值）。

例如，如果我们在数据库中定义序列，其 INCREMENT BY 值为 20，则将 SequenceGenerator 中的分配大小也设置为 20。在这种情况下，JPA 不会调用数据库，直到它达到下一个 20 标记，同时递增每个标记。内部值减1。这节省了每次获取下一个序列号的数据库调用。
这样做的副作用是 - 每当应用程序重新部署或服务器在其间重新启动时，它都会调用数据库来获取下一批，您将看到序列值中的跳跃。此外，我们还需要确保数据库定义和应用程序设置保持同步，但这可能无法始终实现，因为它们都由不同的组管理，您很快就会失去控制。如果数据库值小于分配大小，您将看到由于 Id 值重复而导致的 PrimaryKey 约束错误。如果数据库值高于分配大小，您将看到 Id 值的跳跃。

如果数据库序列 INCREMENT BY 设置为 1（这是 DBA 通常所做的），请将 AllocationSize 也设置为 1，以便它们同步，但 JPA 每次都会调用数据库来获取下一个序列号。

如果您不想每次都调用数据库，请使用GenerationType.IDENTITY策略并由数据库触发器设置@Id值。使用 GenerationType.IDENTITY，一旦我们调用 em.persist，对象就会保存到数据库中，并且 id 的值会分配给返回的对象，因此我们不必执行em.merge或em.flush。 （这可能是 JPA 提供程序特定的......不确定）

另一件重要的事情 -

JPA 2.0 自动运行ALTER SEQUENCE 命令来同步数据库序列中的allocationSize 和INCRMENT BY。由于大多数情况下我们使用不同的架构名称（应用程序用户名）而不是序列存在的实际架构，并且应用程序用户名将不具有 ALTER SEQUENCE 权限，因此您可能会在日志中看到以下警告 -

000004c1 运行时 W CWWJP9991W: openjpa.Runtime: 警告: 无法
缓存序列“RECORD_ID_SEQ”的序列值。你的
应用程序无权运行 ALTER SEQUENCE 命令。
确保它具有运行 ALTER SEQUENCE 的适当权限
命令。

由于 JPA 无法更改序列，因此无论 @SequenceGenerator.allocationSize 的值如何，JPA 每次都会调用数据库来获取下一个序列号。这可能是我们需要意识到的不良后果。

要让 JPA 不运行此命令，请在 persistence.xml 中设置此值。这可确保 JPA 不会尝试运行 ALTER SEQUENCE 命令。但它写了一个不同的警告 -

00000094 运行时 W CWWJP9991W: openjpa.Runtime: 警告:
属性“openjpa.jdbc.DBDictionary=disableAlterSeqenceIncrementBy”是
设置为 true。这意味着“ALTER SEQUENCE...INCRMENT BY”SQL
不会对序列“RECORD_ID_SEQ”执行语句。 OpenJPA
执行此命令以确保序列的 INCREMENT BY 值
数据库中定义的分配大小与中定义的分配大小匹配
实体的序列。禁用此 SQL 语句后，它是
用户有责任确保实体的顺序
定义与数据库中定义的序列匹配。

正如警告中所指出的，这里重要的是我们需要确保数据库序列定义中的 @SequenceGenerator.allocationSize 和 INCRMENT BY 同步，包括 @SequenceGenerator(allocationSize) 的默认值 50。否则会导致错误。

Answer 4

我用这个并且效果很好

@Id
@GeneratedValue(generator = "SEC_ODON", strategy = GenerationType.SEQUENCE)
@SequenceGenerator(name = "SEC_ODON", sequenceName = "SO.SEC_ODON",allocationSize=1)
@Column(name="ID_ODON", unique=true, nullable=false, precision=10, scale=0)
public Long getIdOdon() {
    return this.idOdon;
}

Answer 5

我有带有 autogen 值的 MySQL 架构。我使用 strategy=GenerationType.IDENTITY 标签，并且似乎在 MySQL 中工作正常，我想它也应该适用于大多数数据库引擎。

CREATE TABLE user (
    id bigint NOT NULL auto_increment,
    name varchar(64) NOT NULL default '',
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

User.java：

// mark this JavaBean to be JPA scoped class
@Entity
@Table(name="user")
public class User {
    @Id @GeneratedValue(strategy=GenerationType.IDENTITY)
    private long id;    // primary key (autogen surrogate)

    @Column(name="name")
    private String name;

    public long getId() { return id; }
    public void setId(long id) { this.id = id; }

    public String getName() { return name; }
    public void setName(String name) { this.name=name; }
}

Answer 6

创建表后，我必须在 postgresql 上创建一个序列。
请记住，让 spring 处理数据库序列并不是一个好主意。
删除 @GenerateValue(strategy=GenerationType.SEQUENCE)，

添加到您的模型上

@GeneratedValue(generator="my_seq")
@SequenceGenerator(name="my_seq",sequenceName="MY_SEQ", allocationSize=1)

并在 SQL 上运行

CREATE SEQUENCE my_seq
INCREMENT BY 1;