Что такое Sequence?

Что такое Sequence?

Определение

Sequence в контексте базы данных — это объект СУБД (систем управления базой данных), который автоматически генерирует уникальные числовые значения. Обычно используется для создания первичных ключей (Primary Key) таблиц, обеспечивая каждой новой записи уникальный идентификатор.

В различных СУБД

PostgreSQL:

-- Создание Sequence
CREATE SEQUENCE user_id_seq START 1 INCREMENT 1;

-- Использование в таблице
CREATE TABLE users (
    id INTEGER PRIMARY KEY DEFAULT nextval('user_id_seq'),
    name VARCHAR(100)
);

-- Или более просто
CREATE TABLE users (
    id SERIAL PRIMARY KEY, -- SERIAL - это SEQUENCE + DEFAULT
    name VARCHAR(100)
);

-- Получить следующее значение
SELECT nextval('user_id_seq');

-- Получить текущее значение
SELECT currval('user_id_seq');

Oracle:

-- Создание Sequence
CREATE SEQUENCE user_seq
START WITH 1
INCREMENT BY 1
NOMAXVALUE
NOMINVALUE
CACHE 20;

-- Использование
CREATE TABLE users (
    id NUMBER PRIMARY KEY,
    name VARCHAR2(100)
);

-- INSERT с Sequence
INSERT INTO users (id, name) VALUES (user_seq.NEXTVAL, 'John');

-- Получить текущее
SELECT user_seq.CURRVAL FROM dual;

MySQL:

-- MySQL использует AUTO_INCREMENT вместо Sequence
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100)
);

-- Получить последний id
SELECT LAST_INSERT_ID();

-- Хотя в MySQL 8+ есть поддержка Sequence
CREATE SEQUENCE user_seq;
SELECT NEXT VALUE FOR user_seq;

Типы генерации ID

Sequence - для простых числовых id
AUTO_INCREMENT - встроенный механизм MySQL
UUID - уникальные строки (не числа)
Snowflake ID - распределённые id

В Java с JPA/Hibernate

Аннотация для генерации ID:

import javax.persistence.*;

@Entity
@Table(name = "users")
public class User {
    // Стратегия 1: SEQUENCE
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq")
    @SequenceGenerator(
        name = "user_seq",
        sequenceName = "user_id_seq",
        allocationSize = 1
    )
    private Long id;
    
    private String name;
    private String email;
}

Другие стратегии:

@Entity
public class User {
    // AUTO - Hibernate выбирает оптимальную
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;
}

@Entity
public class User {
    // IDENTITY - использует AUTO_INCREMENT
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
}

@Entity
public class User {
    // TABLE - использует отдельную таблицу для счётчика
    @Id
    @GeneratedValue(strategy = GenerationType.TABLE, generator = "user_table_gen")
    @TableGenerator(
        name = "user_table_gen",
        table = "id_generator",
        pkColumnName = "gen_name",
        valueColumnName = "gen_value",
        pkColumnValue = "user_id",
        allocationSize = 50
    )
    private Long id;
}

@Entity
public class User {
    // UUID - уникальные идентификаторы
    @Id
    @GeneratedValue(generator = "uuid")
    @GenericGenerator(name = "uuid", strategy = "uuid2")
    private UUID id;
}

Практические примеры

Пример 1: Simple Sequence

@Entity
@Table(name = "products")
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "product_seq_gen")
    @SequenceGenerator(
        name = "product_seq_gen",
        sequenceName = "product_id_seq",
        initialValue = 100,
        allocationSize = 1
    )
    private Long id;
    
    private String name;
    private Double price;
    private String description;
}

Пример 2: Многоуровневый ID

@Entity
@Table(name = "orders")
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "order_seq_gen")
    @SequenceGenerator(
        name = "order_seq_gen",
        sequenceName = "order_id_seq",
        allocationSize = 5 // Оптимизация: берёт по 5 значений за раз
    )
    private Long id;
    
    private LocalDateTime createdAt;
    
    @ManyToOne
    @JoinColumn(name = "user_id")
    private User user;
    
    private BigDecimal total;
}

Пример 3: Кастомная реализация

public class CustomIdGenerator implements IdentifierGenerator {
    @Override
    public Serializable generate(SessionImplementor session, Object object)
            throws HibernateException {
        // Генерируем ID как timestamp + random
        return System.currentTimeMillis() + "-" + UUID.randomUUID().toString();
    }
}

@Entity
public class CustomEntity {
    @Id
    @GeneratedValue(generator = "custom_gen")
    @GenericGenerator(name = "custom_gen", strategy = "com.example.CustomIdGenerator")
    private String id;
}

Параметры Sequence

CREATE SEQUENCE seq_name
START WITH 1           -- Начальное значение
INCREMENT BY 1         -- Шаг увеличения
MINVALUE 1             -- Минимальное значение
MAXVALUE 9999999       -- Максимальное значение
CYCLE                  -- Циклировать после MAXVALUE
CACHE 20               -- Кэшировать значения (оптимизация)
NOORDER;               -- Порядок не гарантирован

Производительность и оптимизация

allocationSize - критичный параметр:

// ❌ МЕДЛЕННО - обращается к БД на каждый INSERT
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq_gen")
@SequenceGenerator(
    name = "user_seq_gen",
    sequenceName = "user_id_seq",
    allocationSize = 1 // Берёт по одному значению
)
private Long id;

// ✅ БЫСТРО - кэширует значения
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq_gen")
@SequenceGenerator(
    name = "user_seq_gen",
    sequenceName = "user_id_seq",
    allocationSize = 50 // Берёт по 50 значений за раз
)
private Long id;

Проблемы и решения

Проблема 1: Gaps в ID (пропуски)

-- Когда используется allocationSize > 1
-- ID: 1, 2, 3, 50, 51, 52, ...
-- allocationSize = 50 зарезервировал 50-99, но сервер упал
-- Следующий сервер начнёт с 100

-- Решение: это нормально, используй allocationSize = 1 если критично

Проблема 2: Исчерпание значений

@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "seq")
@SequenceGenerator(
    name = "seq",
    sequenceName = "my_seq",
    initialValue = 1,
    allocationSize = 1
    // Без MAXVALUE - бесконечный диапазон (рекомендуется)
)
private Long id;

Проблема 3: Кластеризованные таблицы

@Entity
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "order_seq")
    @SequenceGenerator(
        name = "order_seq",
        sequenceName = "order_id_seq",
        allocationSize = 20 // Меньше для распределённых систем
    )
    private Long id;
}

Альтернативы Sequence

UUID:

@Entity
public class User {
    @Id
    @GeneratedValue(generator = "uuid")
    @GenericGenerator(name = "uuid", strategy = "uuid2")
    private UUID id;
}

Snowflake ID (для микросервисов):

@Entity
public class Event {
    @Id
    @GeneratedValue(generator = "snowflake")
    @GenericGenerator(name = "snowflake", strategy = "com.example.SnowflakeIdGenerator")
    private Long id;
}

Timestamp-based:

@Entity
public class AuditLog {
    @Id
    private Long id;
    
    @PrePersist
    protected void onCreate() {
        id = System.currentTimeMillis();
    }
}

Мониторинг Sequence

-- PostgreSQL - просмотр текущего значения
SELECT last_value FROM user_id_seq;

-- Oracle - просмотр информации о Sequence
SELECT * FROM user_sequences WHERE sequence_name = 'USER_SEQ';

-- Сброс Sequence
ALTER SEQUENCE user_id_seq RESTART WITH 1;

Лучшие практики

// ✅ 1. Используй SEQUENCE для PostgreSQL
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "seq")

// ✅ 2. Оптимизируй allocationSize
@SequenceGenerator(allocationSize = 50) // Зависит от load

// ✅ 3. Документируй начальное значение
@SequenceGenerator(initialValue = 1000) // Понятно почему

// ✅ 4. Используй UUID для распределённых систем
@GeneratedValue(generator = "uuid")

// ❌ 5. НЕ полагайся на порядок ID
// IDs не гарантированно последовательные если есть пропуски

// ✅ 6. Используй типь Long, не Integer
@Id
private Long id; // Хватит на 9 миллиардов записей

Итог

Sequence — это механизм СУБД для автоматической генерации уникальных значений. Главные моменты:

• PostgreSQL использует SEQUENCE, MySQL - AUTO_INCREMENT
• allocationSize критичен для производительности
• UUID - альтернатива для распределённых систем
• Type Long - всегда выбирай для id
• В Hibernate используй @GeneratedValue аннотации

Выбор между SEQUENCE, AUTO_INCREMENT и UUID зависит от архитектуры и требований проекта.