Firebird Generator Guide: A guide on how and when to use generators in Firebird

• 语言: 英语
• 格式: .pdf
• 来源: firebirdsql.org

摘要

本文档详细介绍了Firebird数据库中的生成器（generator）的概念、使用方法及其相关SQL语句。生成器用于生成唯一的ID值，类似于其他数据库中的自增字段或序列。文档涵盖了生成器的创建、获取当前值、生成下一个值、设置值以及删除等操作，并比较了传统语法与Firebird 2推荐的新语法（如CREATE SEQUENCE和NEXT VALUE FOR）的区别。文档还讨论了生成器的限制及在不同Firebird版本中的应用。

AI总结

《Firebird Generator Guide: A guide on how and when to use generators in Firebird》摘要

本文档系统地介绍了Firebird数据库中生成器（Generator）的概念、功能及其使用方法，旨在帮助用户理解生成器的作用，并指导其在实际应用中正确使用。以下是核心内容的总结：

### 1. 生成器的基本概念
- **生成器的作用**：生成器用于生成唯一的数值，类似于其他关系型数据库中的“AutoInc”字段或Oracle中的“Sequence”。生成器值保存在`RDB$GENERATORS`系统表中。
- **生成器的最大值**：生成器的最大值为32767。
- **生成器的数量**：Firebird数据库可以创建多达32767个生成器。

### 2. 生成器的SQL语句
生成器的操作可以通过以下SQL语句完成：

#### 2.1 创建生成器
- **客户端SQL**：
- 使用`CREATE GENERATOR GeneratorName;` creates a new generator.
- Firebird 2及以上版本推荐使用`CREATE SEQUENCE SequenceName;`。
- **PSQL（存储过程和触发器中的Procedural SQL）**：不支持直接创建生成器，但Firebird 1.5及以上版本可以通过`EXECUTE STATEMENT`绕过此限制。

#### 2.2 获取当前值
- **客户端SQL**：
- `SELECT GEN_ID(GeneratorName, 0) FROM RDB$DATABASE;` 获取当前值。
- Firebird 2及以上版本推荐使用`SELECT NEXT VALUE FOR SequenceName FROM RDB$DATABASE;`。
- **PSQL**：使用`intvar = GEN_ID(GeneratorName, 0);`。

#### 2.3 生成下一个值
- **客户端SQL**：
- `GEN_ID(GeneratorName, 1)`生成下一个值，Firebird 2及以上版本推荐使用`NEXT VALUE FOR SequenceName`。
- **PSQL**：使用`intvar = GEN_ID(GeneratorName, 1);`或`intvar = NEXT VALUE FOR SequenceName;"。

#### 2.4 设置生成器值
- **客户端SQL**：使用`SET GENERATOR GeneratorName TO NewValue;`设置生成器值。
- **PSQL**：通过`GEN_ID(GeneratorName, NewValue - GEN_ID(GeneratorName, 0))`间接设置值。
- **Firebird 2推荐语法**：`ALTER SEQUENCE SequenceName RESTART WITH NewValue;`。

#### 2.5 删除生成器
- **客户端SQL**：使用`DROP GENERATOR GeneratorName;`。
- **Firebird 2推荐语法**：`DROP SEQUENCE SequenceName;`。
- **旧版本兼容**：在InterBase 6及早期版本中，无法直接删除生成器，需通过删除`RDB$GENERATORS`表中的记录并执行备份恢复来完成。

### 3. 生成器的使用建议
- **唯一行ID**：生成器可用于创建唯一的行ID，避免在插入记录时手动管理主键。
- **替代AutoInc**：生成器是Firebird中模拟其他数据库“AutoInc”字段的主要方式。
- **版本兼容性**：Firebird 2引入了`SEQUENCE`语法，推荐优先使用新语法，旧语法仍然支持但不建议长期使用。

### 4. 其他注意事项
- **生成器空间管理**：删除生成器不会释放空间，若数据库生成器数量接近上限32767，可通过备份恢复数据库来释放空间。
- **存储过程和触发器**：PSQL中不支持直接修改数据库元数据，生成器的创建和删除需在客户端SQL中完成。

### 5. 文档信息
- **版本历史**：文档多次更新，新增了Firebird 2的语法说明和生成器的使用建议。
- **许可证**：本文档以Public Documentation License Version 1.0发布。

通过本文档，用户可以全面了解Firebird生成器的功能及其操作方法，并在实际数据库设计和开发中合理利用生成器实现业务需求。