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

《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生成器的功能及其操作方法，并在实际数据库设计和开发中合理利用生成器实现业务需求。