FAQ Interbase/FirebirdConsultez toutes les FAQ

Un générateur est un numéroteur unique. Il va donc servir principalement à créer des identifiants uniques.

Pourquoi utiliser un générateur plutôt qu'une procédure ou une table de numéros ? Et bien il faut savoir que les opérations sur les générateurs ne font pas partie de la transaction en cours. Ce qui veut dire que si on incrémente dans une transaction T1 un générateur, cette action est immédiatement visible des autres transanctions en cours ou futures. De plus l'abandon de T1 (RollBack) ne va pas altérer le générateur, il restera avec sa valeur incrémentée. Vous me direz que le numéro n'a donc pas été utilisé. Et oui il peut donc y avoir des 'trous', mais le but premier est l'unicité, ce qui est bien réalisé ici.

On peut créer autant de générateur qu'on en a besoin de la manière suivante :

CREATE GENERATOR GEN_MON_GENERATEUR;

SET GENERATOR GEN_MON_GENERATEUR TO 1000;

Pour supprimer un générateur exécutez le code ci-dessous (après vous être assuré qu'il n'est plus utilisé par les applications clientes ou par la base.

1
2
delete from RDB$GENERATORS where  
RDB$GENERATOR_NAME = 'GEN_MON_GENERATEUR';

Pour optenir un nouveau numéro unique il faut utiliser la fonction gen_id(NomDuGénérateur, ValeurIncrement).

gen_id(GEN_MON_GENERATEUR,1)

1
2
3
4
5
6
7
CREATE PROCEDURE SP_GEN_MON_GENERATEUR 
RETURNS (ID INTEGER) 
AS 
BEGIN 
  ID = GEN_ID(GEN_MON_GENERATEUR, 1); 
  SUSPEND; 
END

1
2
3
4
5
6
7
8
CREATE TRIGGER MON_TRIGGER_BI FOR MA_TABLE 
ACTIVE BEFORE INSERT POSITION 0 
AS 
  
BEGIN 
  IF (NEW.MA_CLE_PRIMAIRE IS NULL) THEN 
    NEW.MA_CLE_PRIMAIRE = GEN_ID(GEN_MON_GENERATEUR,1); 
END

1
2
INSERT INTO MA_TABLE (MA_CLE_PRIMAIRE, NOM,  
PRENOM) VALUES (GEN_ID(GEN_MON_GENERATEUR,1), 'Barbibulle', NULL);

1
2
SELECT GEN_ID(GEN_MON_GENERATEUR,1) FROM  
RDB$DATABASE;

Pour lire un générateur sans l'affecter il suffit de faire :

gen_id(GEN_MON_GENERATEUR,0)