Seuls les paramètres nommés sont autorisés dans les instructions DML (SELECT, INSERT, UPDATE, DELETE etc.) Si les instructions DML contiennent des paramètres nommés, ils doivent d’abord être déclarés comme variables locales dans l’instruction DECLARE [VARIABLE] de l’en-tête du module ou être disponibles dans les paramètres d’entrée ou de sortie du module PSQL.

Lors de l’utilisation de paramètres nommés dans des instructions DML, le préfixe deux-points “:” est obligatoire, mais dans l’instruction INTO, le caractère deux-points est facultatif. Le préfixe deux-points est facultatif dans les instructions spécifiques à PSQL, telles que les instructions de branchement ou d’affectation. Le préfixe deux-points n’est pas non plus nécessaire lors de l’appel d’une procédure stockée à l’aide de l’instruction EXECUTE PROCEDURE depuis un autre module PSQL.

Les procédures et fonctions stockées, y compris celles contenues dans les packages, sont exécutées dans le contexte de la transaction dans laquelle elles ont été lancées. Les déclencheurs sont exécutés dans le contexte de la transaction dans laquelle l’instruction DML déclenchant le déclencheur a été exécutée. Une transaction distincte est lancée pour les déclencheurs sur un événement de base de données.

PSQL ne permet pas les instructions de début et de fin de transaction, mais il est possible d’exécuter une instruction ou un bloc d’instructions dans une transaction autonome.

La syntaxe des modules PSQL se distingue par un en-tête et un corps. Les instructions DDL pour leur déclaration sont des instructions complexes, c’est-à-dire qu’elles consistent en une seule instruction qui comprend des blocs de plusieurs instructions. Ces instructions commencent par un verbe (CREATE, ALTER, DROP, RECREATE, CREATE OR ALTER) et se terminent par la dernière instruction END du corps du module.

L’en-tête contient le nom du module et la description des variables locales. Pour les procédures stockées et les blocs PSQL, l’en-tête peut contenir la description des paramètres d’entrée et de sortie. L’en-tête du déclencheur ne peut pas contenir de paramètres d’entrée et de sortie.

L’en-tête du déclencheur doit contenir un événement (ou une combinaison d’événements), auquel le déclencheur sera appelé automatiquement.

Le code PSQL peut être exécuté dans l’un des modes suivants :

Les privilèges d’exécution du module PSQL sont spécifiés dans son en-tête dans la clause optionnelle SQL SECURITY.Si l’option INVOKER est sélectionnée, le module PSQL est exécuté avec les privilèges de l’utilisateur appelant.Si l’option DEFINER est sélectionnée, le module PSQL est exécuté avec les privilèges de l’utilisateur définissant (propriétaire). Ces privilèges seront complétés par des privilèges accordés au module PSQL lui-même à l’aide de l’Instruction GRANT.Par défaut, les procédures, les fonctions sont exécutées avec les privilèges de l’utilisateur appelant, et les déclencheurs héritent des privilèges de sécurité spécifiés pour la table.

Les blocs PSQL anonymes (EXECUTE BLOCK) sont toujours exécutés avec les privilèges de l’appelant.

Le corps du module peut être écrit en PSQL ou être le corps d’un module externe.

Le corps PSQL commence par une section facultative dans laquelle sont déclarés les variables, les curseurs et les sous-programmes. Cette section est suivie d’un bloc d’instructions, qui sont exécutées dans une séquence logique en tant que programme. Le bloc d’instructions - ou instruction composée - est entouré des mots-clés BEGIN et END et est exécuté comme un seul bloc de code. Le bloc principal BEGIN …​ END peut contenir un nombre quelconque d’autres blocs BEGIN …​ END, soit en ligne ou séquentiel. L’imbrication maximale des blocs est de 512 niveaux. Toutes les instructions sauf BEGIN et END se terminent par un point-virgule (“;”). Aucun autre caractère ne peut être utilisé comme terminaison pour les instructions PSQL.

Changez le(s) caractère(s) de terminaison pour éviter tout conflit avec le terminateur dans les instructions PSQL.

ISQL.

Lors de l’écriture de déclencheurs et de procédures stockées dans les textes de script qui créent les objets de base de données nécessaires pour éviter toute ambiguïté sur l’utilisation des Instructions de terminaison (par les normes SQL est un point-virgule) utilisé Instruction SET TERM , qui à proprement parler n’est pas un Instruction SQL, et la commande outil interactif isql.Cet Instruction définit un caractère ou une chaîne de caractères à la fin du texte du déclencheur ou de la procédure stockée avant de créer le déclencheur ou la procédure stockée. Après avoir décrit le texte de l’objet de programme correspondant avec le même Instruction SET TERM, la valeur du terminateur redevient un point-virgule.

Le terminateur alternatif peut être n’importe quelle chaîne de caractères arbitraire, à l’exception des points-virgules, des espaces et des apostrophes. Si vous utilisez un caractère alphabétique, il sera sensible à la casse.

Le corps du module externe définit le moteur UDR utilisé pour exécuter le module externe et spécifie en outre le nom de la procédure UDR appelée (<extname>) et/ou une chaîne (<extbody>) avec une sémantique spécifique à l’UDR.

La configuration des modules externes et des mécanismes UDR n’est pas abordée dans ce guide linguistique. Pour plus de détails, reportez-vous à la documentation du moteur UDR spécifique.

Les procédures stockées présentent les avantages suivants:

Prise en charge simplifiée des applications : lorsqu’une procédure stockée est modifiée, les changements sont immédiatement répercutés dans toutes les applications sans qu’il soit nécessaire de les recompiler.

Performances accrues : les procédures stockées étant exécutées côté serveur et non côté client, cela réduit le trafic réseau, ce qui améliore les performances.

Il existe deux types de procédures stockées, les procédures stockées exécutables et les procédures stockées sélectionnables.

Les procédures stockées exécutables, effectuent le traitement des données stockées dans une base de données. Ces procédures peuvent recevoir des paramètres d’entrée et retourner un seul ensemble de paramètres de sortie (RETURNS). Ces procédures sont exécutées à l’aide de l’Instruction EXECUTE PROCEDURE. exemple création d’une procédure stockée à exécuter à la fin de la sectionCREATE PROCEDURE chapitres sur les "Instructions DDL".

Les procédures stockées sélectives récupèrent généralement des données dans une base de données et renvoient un nombre arbitraire de lignes.

De telles procédures produisent des ensembles de données assez complexes qui sont souvent impossibles ou très difficiles à récupérer avec des requêtes DSQL SELECT classiques. Ces procédures effectuent généralement un processus cyclique de récupération des données, éventuellement de transformation avant de remplir les variables de sortie (paramètres) avec de nouvelles données à chaque itération de la boucle. L’Instruction SUSPEND, généralement situé à la fin de chaque itération, remplit un tampon et attend qu’un appelant sélectionne (fetch) une ligne.

Les procédures sélectives peuvent avoir des paramètres d’entrée et un ensemble de sortie spécifiés dans la clause RETURNS de l’en-tête de la procédure.

On accède à la procédure stockée sélective en utilisant l’Instruction SELECT (voir Select from Selective Stored Procedure).Voir exemple de création d’une procédure stockée sélective à la fin du chapitre CREATE PROCEDURE "Instructions de définition de données DDL".

La syntaxe pour créer des procédures stockées exécutables et des procédures sélectives n’est pas différente. La différence réside dans la logique du code du programme.

Pour des informations sur la création de procédures stockées, voir CREATE PROCEDURE dans le chapitre "Instructions de définition de données DDL".

Dans les procédures stockées existantes, l’ensemble des paramètres d’entrée et de sortie et le corps de la procédure peuvent être modifiés.

Pour plus d’informations sur la modification des procédures stockées existantes, reportez-vous à la section consacrée à la modification des procédures stockées.ALTER PROCEDURE,CREATE OR ALTER PROCEDURE,RECREATE PROCEDURE dans le chapitre "Instructions de définition de données DDL".

Pour des informations sur la suppression des procédures stockées, voir DROP PROCEDURE dans le chapitre "Instructions de définition de données DDL".

Pour plus d’informations sur la création de fonctions stockées, voir. CREATE FUNCTION au chapitre "Instructions de définition de données DDL".

Pour plus d’informations sur la modification des fonctions stockées existantes, reportez-vous à la rubriqueALTER FUNCTION,CREATE OR ALTER FUNCTION,RECREATE FUNCTION dans le chapitre "Instructions de définition de données DDL".

Pour plus d’informations sur la suppression des fonctions stockées, voir. DROP FUNCTION dans le chapitre "Instructions de définition de données DDL".

Les paquets présentent les avantages suivants :

Pour plus d’informations sur la création de paquets, reportez-vous àCREATE PACKAGE, CREATE PACKAGE BODY.

Pour plus d’informations sur la modification d’un en-tête ou d’un corps de paquet existant, reportez-vous à la rubrique ALTER PACKAGE,CREATE OR ALTER PACKAGE,RECREATE PACKAGE,RECREATE PACKAGE BODY.

Pour plus d’informations sur la manière de supprimer un paquet, reportez-vous à la rubrique DROP PACKAGE, DROP PACKAGE BODY.

Plus d’un trigger peut être défini pour chaque combinaison phase-événement. L’ordre dans lequel ils sont exécutés peut être spécifié explicitement avec l’argument optionnel POSITION dans la définition du trigger. La position maximale est de 32767. Les triggers avec une position plus petite sont appelés en premier.

Si la clause POSITION est omise ou si plusieurs déclencheurs avec la même phase et le même événement ont la même position, ces déclencheurs seront exécutés dans l’ordre alphabétique de leurs noms.

Les déclencheurs DML sont déclenchés lorsque l’état des données est modifié par des opérations DML : modification, ajout ou suppression de lignes. Ils peuvent être définis à la fois pour les tables et les vues.

Il existe six options de base pour la relation de phase d’événement pour une table (vue) :

En plus des formulaires de base avec une seule phase et un seul événement, Firebird supporte également les formulaires avec une seule phase et plusieurs événements, tels que BEFORE INSERT OR UPDATE OR DELETE ou AFTER UPDATE OR DELETE ou toute autre combinaison de votre choix.

Variables de contexte INSERTING, UPDATING et DELETING de type booléen peut être utilisé dans le corps du déclencheur pour déterminer l’événement qui a déclenché le déclencheur.

Dans les triggers DML, Firebird donne accès à un ensemble de variables contextuelles NEW et OLD.Chaque ensemble est un tableau de la chaîne entière : OLD.* — la valeur de la chaîne avant la modification des données et NEW.* — la valeur de la chaîne requise ("nouvelle").Les Instructions peuvent s’y référer en utilisant les formes suivantes : NEW.columnname et OLD.columnname.La colonne columnname_ peut être n’importe quelle colonne définie dans la table (vue), pas seulement celle qui a été modifiée.

Les variables de contexte NEW et OLD obéissent aux règles suivantes :

Un déclencheur associé à un événement de la base de données peut être déclenché lorsque les événements suivants se produisent :

Variable de contexte RESETTING peut être utilisé dans les déclencheurs des événements ON CONNECT et ON DISCONNECT pour distinguer la réinitialisation de la session et la connexion/déconnexion de la base de données.

Les déclencheurs DDL sont déclenchés sur des événements de changement de métadonnées spécifiés dans l’une des phases de l’événement. Les déclencheurs BEFORE sont déclenchés avant les changements dans les tables du système. Les déclencheurs AFTER sont déclenchés après les changements dans les tables du système.

Pendant que le déclencheur DDL est en cours d’exécution, l’espace de noms DDL_TRIGGER est disponible pour être utilisé dans la fonction RDB$GET_CONTEXT. Son utilisation est également autorisée dans les procédures et fonctions stockées appelées par les déclencheurs DDL.

Le contexte DDL_TRIGGER fonctionne comme une pile. Avant que le trigger DDL ne soit déclenché, les valeurs liées à la commande en cours d’exécution sont placées sur cette pile. Lorsque le trigger est terminé, les valeurs sont éjectées.Ainsi, dans le cas d’instructions DDL en cascade, lorsque chaque commande DDL utilisateur excite un déclencheur DDL, et que ce déclencheur déclenche d’autres commandes DDL, avec EXECUTE STATEMENT, les valeurs des variables dans l’espace de noms DDL_TRIGGER correspondront à la commande qui a déclenché le dernier déclencheur DDL dans la pile d’appels.

Pour plus d’informations sur la création de déclencheurs, reportez-vous àCREATE TRIGGER,CREATE OR ALTER TRIGGER,RECREATE TRIGGER dans le chapitre "Instructions de définition de données DDL".

Pour plus d’informations sur la modification des déclencheurs, reportez-vous à la rubriqueALTER TRIGGER,CREATE OR ALTER TRIGGER,RECREATE TRIGGER dans le chapitre "Instructions de définition de données DDL".

Pour plus d’informations sur la suppression des déclencheurs, voir "Suppression des déclencheurs".DROP TRIGGER dans le chapitre "Instructions de définition de données DDL".

Attribution d’une valeur à une variable.

PSQL

PSQL utilise le signe égal (‘`=`’) comme Instruction d’affectation. L’Instruction d’affectation définit la variable à gauche de l’Instruction à la valeur de l’expression SQL à droite. Une expression peut être n’importe quelle expression SQL valide. Elle peut contenir des littéraux, des noms de variables internes, des opérations arithmétiques, logiques et de chaînes de caractères, des appels à des fonctions intégrées et des fonctions définies par l’utilisateur.

DECLARE VARIABLE.

Sortir du cycle.

PSQL

L’instruction LEAVE termine immédiatement la boucle interne des instructions WHILE ou FOR. En utilisant le paramètre optionnel label, LEAVE peut également quitter la boucle externe, c’est-à-dire la boucle marquée par `. Le code continue à s’exécuter à partir de la première instruction après le bloc de boucle terminé.

BREAK, EXIT, CONTINUE.

Un départ précoce pour une nouvelle itération du cycle.

PSQL

L’instruction CONTINUE saute le reste du bloc de la boucle courante et démarre l’itération suivante de la boucle courante WHILE ou FOR. En utilisant le paramètre optionnel label, CONTINUE peut aussi démarrer l’itération suivante pour une boucle externe, c’est-à-dire la boucle marquée avec label.

LEAVE, BREAK.

Fin d’une procédure, d’une fonction ou d’un déclencheur.

PSQL

L’instruction EXIT appelée depuis n’importe où dans le module PSQL en cours d’exécution sautera à la dernière instruction END, terminant ainsi l’exécution du programme.

Si vous appelez EXIT dans une fonction, celle-ci retournera NULL.

Transfère les valeurs des paramètres dans un tampon et met en pause la procédure (bloc PSQL) jusqu’à ce que l’appelant reçoive le résultat.

PSQL

L’instruction SUSPEND envoie les valeurs des paramètres de sortie dans le tampon et suspend l’exécution de la procédure stockée (bloc PSQL). L’exécution reste suspendue jusqu’à ce que l’appelant reçoive le contenu du tampon. L’exécution reprend avec l’instruction qui suit immédiatement l’instruction SUSPEND. Le plus souvent, il s’agira d’une nouvelle itération du processus itératif.

EXIT.

Exécution d’instructions SQL générées dynamiquement.

PSQL

L’instruction EXECUTE STATEMENT prend un paramètre de type chaîne et l’exécute comme s’il s’agissait d’une instruction DSQL. Si l’instruction renvoie des données, celles-ci peuvent être passées à des variables locales à l’aide de l’instruction INTO.

Vous pouvez utiliser des paramètres dans une instruction DSQL. Les paramètres peuvent être nommés ou positionnels (sans nom). Une valeur doit être attribuée à chaque paramètre.

Par défaut, l’instruction est exécutée dans le contexte de la transaction courante. En utilisant la clause WITH AUTONOMOUS TRANSACTION, une nouvelle transaction sera lancée avec les mêmes paramètres que la transaction courante. Elle sera acquittée si l’instruction est exécutée sans erreur et annulée (roll back) sinon.Avec la clause WITH COMMON TRANSACTION , la transaction courante est utilisée dans la mesure du possible.

Si l’instruction doit être exécutée dans une connexion distincte, la transaction déjà en cours d’exécution dans cette connexion est utilisée (le cas échéant). Sinon, une nouvelle transaction est lancée avec les paramètres de la transaction courante. Toute nouvelle transaction lancée en mode COMMON est confirmée ou annulée en même temps que la transaction courante.

Par défaut, les instructions SQL sont exécutées avec les privilèges de l’utilisateur courant. La spécification WITH CALLER PRIVILILEGES leur ajoute des privilèges pour appeler une procédure stockée ou un déclencheur, tout comme si l’instruction était exécutée directement par un sous-programme. WITH CALLER PRIVILEGES n’a aucun effet si la clause ON EXTERNAL est également présente.

Avec la clause ON EXTERNAL DATA SOURCE, l’instruction est exécutée dans une connexion séparée à la même base de données ou à une autre, éventuellement sur un serveur différent. Si la chaîne de connexion est définie à NULL ou '' (chaîne vide), la clause ON EXTERNAL est considérée comme manquante et l’instruction est exécutée pour la base de données actuelle. La chaîne de connexion est détaillée dans l’instruction CREATE DATABASE.Voir. Création d’une base de données sur un serveur distant.

Le pool de connexion et le pool de transaction sont utilisés lors de l’exécution d’une instruction dans une connexion séparée.

Pour éviter les retards liés à l’utilisation fréquente de connexions externes, le sous-système de sources de données externes (EDS) utilise un pool de connexions externes.Le pool stocke les connexions externes non utilisées pendant un certain temps, évitant ainsi les coûts de connexion/déconnexion pour les chaînes de connexion fréquemment utilisées.

Comment fonctionne la mise en commun des connexions :

Caractéristiques principales :

Paramètres du pool de connexion externe :

Le pool de connexions externes et ses paramètres peuvent être contrôlés par des Instructions spéciaux.Voir ALTER EXTERNAL CONNECTIONS POOL pour plus de détails.

L’état du pool de connexion externe peut être interrogé à l’aide de variables contextuelles dans l’espace de noms SYSTEM.

Lorsque vous utilisez la clause ON EXTERNAL, une connexion supplémentaire est toujours établie par le biais d’un fournisseur externe, même s’il s’agit d’une connexion à la base de données actuelle. Une conséquence de ceci est que vous ne pouvez pas gérer les exceptions de la manière habituelle.Chaque exception levée par l’instruction renvoie une erreur eds_connection ou eds_statement. Vous devez utiliser WHEN GDSCODE eds_connection, WHEN GDSCODE eds_statement ou WHEN ANY pour gérer les exceptions dans le code PSQL.

Les clauses facultatives AS USER, PASSWORD et ROLE vous permettent de spécifier au nom de quel utilisateur, et avec quel rôle, l’instruction SQL sera exécutée.La façon dont l’utilisateur est autorisé et si une connexion séparée est ouverte dépend de la présence et des valeurs des paramètres ON EXTERNAL [DATA SOURCE], AS USER, PASSWORD et ROLE.

En général, cette fonction doit être utilisée avec beaucoup de précaution, et les facteurs mentionnés ci-dessus doivent toujours être pris en compte.Si le même résultat peut être obtenu en utilisant PSQL et/ou DSQL, c’est toujours préférable.

FOR EXECUTE STATEMENT.

Parcourir les lignes du résultat de l’Instruction SELECT.

PSQL

L’instruction FOR SELECT sélectionne la ligne suivante dans une table (vue, procédure stockée sélective), suivie d’une instruction composée. À chaque itération de la boucle, les valeurs des champs de la ligne courante sont copiées dans des variables locales. L’ajout de la clause AS CURSOR rend possible la suppression et la mise à jour des données positionnelles. Les instructions FOR SELECT peuvent être imbriquées.

L’instruction FOR SELECT peut contenir des paramètres nommés qui doivent être préalablement déclarés dans l’instruction DECLARE VARIABLE, ou dans les paramètres d’entrée (de sortie) d’une procédure (bloc PSQL).

L’instruction FOR SELECT doit contenir une clause INTO à la fin de cette instruction, ou une instruction AS CURSOR. A chaque itération de la boucle, les valeurs des champs de la chaîne de requête courante sont copiées dans la liste de variables spécifiée dans l’instruction INTO. La boucle est répétée jusqu’à ce que toutes les lignes aient été lues. Ensuite, la boucle est quittée. La boucle peut également être terminée avant que toutes les lignes soient lues en utilisant l’instruction LEAVE.

La clause facultative AS CURSOR crée un curseur nommé qui peut être référencé (en utilisant la clause WHERE CURRENT OF) dans l’instruction composée qui suit la clause DO afin de supprimer ou de modifier la ligne courante.

Il est permis d’utiliser le nom du curseur comme une variable de type enregistrement (similaire à OLD et NEW dans les triggers) qui permet d’accéder aux colonnes du jeu résultant (i.e. cursor_name . columnname). L’utilisation de la clause AS CURSOR rend la clause INTO facultative.

SELECT,DECLARE …​CURSOR,OPEN,CLOSE,FETCH.

Exécution d’instructions SQL créées dynamiquement et renvoyant plusieurs lignes de données.

PSQL

L’Instruction FOR EXECUTE STATEMENT est utilisé (de manière similaire à la construction FOR SELECT) pour les Instructions SELECT ou EXECUTE BLOCK qui renvoient plus d’une chaîne.

EXECUTE STATEMENT.

Ouverture du curseur.

PSQL

L’Instruction OPEN ouvre un curseur précédemment déclaré, exécute l’Instruction SELECT qui y est déclaré et récupère les enregistrements de l’ensemble de données résultant. L’Instruction OPEN ne s’applique qu’aux curseurs déclarés dans la section DECLARE …​ CURSOR.

FETCH,CLOSE,DECLARE …​ CURSOR.

Lire un enregistrement de l’ensemble de données associé au curseur.

PSQL

L’instruction FETCH sélectionne la ligne de données suivante dans le jeu de données du curseur résultant et affecte les valeurs des colonnes aux variables PSQL. L’instruction FETCH s’applique uniquement aux curseurs déclarés dans l’instruction DECLARE …​'. CURSOR.

L’Instruction FETCH peut spécifier dans quelle direction et de combien d’enregistrements la position du curseur avance. La clause NEXT peut être utilisée avec des curseurs défilants ou non.

Les autres clauses ne peuvent être utilisées qu’avec des curseurs déroulants.

La clause optionnelle INTO place les données de la ligne courante du curseur dans des variables PSQL.

Il est permis d’utiliser le nom du curseur comme une variable de type d’enregistrement (similaire à OLD et NEW dans les triggers) qui permet d’accéder aux colonnes du jeu résultant (c’est-à-dire cursor_name . columnname).

Pour vérifier que les entrées du jeu de données sont épuisées, la variable contextuelle ROW_COUNT est utilisée pour retourner le nombre de lignes sélectionnées par l’instruction.Si l’enregistrement suivant dans l’ensemble de données est lu, ROW_COUNT est égal à un, sinon zéro.

OPEN, CLOSE, DECLARE …​ CURSOR.

Fermeture du curseur.

PSQL

L’instruction CLOSE ferme un curseur ouvert. Tout curseur encore ouvert sera automatiquement fermé après l’exécution du code déclencheur, de la procédure stockée, de la fonction ou du bloc PSQL anonyme dans lequel il a été ouvert. L’instruction CLOSE s’applique uniquement aux curseurs déclarés dans l’instruction DECLARE …​ CURSOR.

Voir les exemples dans l’Instruction FETCH.

FETCH, OPEN, DECLARE …​ CURSOR.

Déclaration d’une variable locale.

PSQL

L’Instruction DECLARE [VARIABLE] déclare une variable locale. Le mot clé VARIABLE peut être omis. Une seule variable peut être déclarée dans un Instruction. Un nombre arbitraire de variables locales peut être déclaré dans les procédures et les triggers, en utilisant à chaque fois, un nouvel Instruction DECLARE VARIABLE.

Le nom d’une variable locale doit être unique parmi les noms des variables locales, des paramètres d’entrée et de sortie d’une procédure dans un objet de programme.

Le type de données de la variable locale peut être n’importe quel type SQL, à l’exception des tableaux.

Vous pouvez spécifier un nom de domaine comme type de variable.Dans ce cas, la variable hérite de toutes les caractéristiques du domaine.Si la clause TYPE OF est utilisée en plus avant le nom de domaine, seul le type de données du domaine est utilisé — ses restrictions NOT NULL, CHECK et/ou ses valeurs par défaut ne sont pas vérifiées (non utilisées).Si le domaine est un type de texte, son jeu de caractères et son ordre de tri sont toujours utilisés.

Les variables locales peuvent être déclarées en utilisant le type de données colonne des tables et vues existantes.Pour ce faire, on utilise la clause TYPE OF COLUMN, suivie du nom des tables ou de la vue et d’un nom de colonne séparé par un point.Lorsque vous utilisez TYPE OF COLUMN, seul le type de données est hérité, et dans le cas des types de chaînes de caractères, également le jeu de caractères et l’ordre de tri.Les contraintes et les valeurs par défaut de la colonne ne sont jamais utilisées.

La restriction NOT NULL peut être spécifiée pour les variables locales, empêchant ainsi la valeur NULL de lui être passée.

Sauf indication contraire, le jeu de caractères et la séquence de mappage (tri) de la variable chaîne seront les valeurs par défaut de la base de données.

Si nécessaire, la clause CHARACTER SET peut être incluse pour gérer les données de chaînes de caractères qui seront dans un jeu de caractères différent.

Une séquence de mappage valide (clause COLLATE) peut également être incluse avec ou sans CHARACTER SET.

Une variable locale peut être définie par une valeur d’initialisation, qui est définie avec la clause DEFAULT ou l’Instruction =. La valeur par défaut peut être NULL, un littéral ou toute variable contextuelle compatible avec le type de données.

Types et sous-types de données,Types de données utilisateur — domaines,CREATE DOMAIN

Exécution d’un Instruction composé dans une transaction autonome.

PSQL.

L’instruction IN AUTONOMOUS TRANSACTION permet d’exécuter une instruction composée dans une transaction hors ligne. Le code s’exécutant dans une transaction hors ligne sera acquitté immédiatement après son achèvement, quel que soit le statut de la transaction parente. Ceci est nécessaire lorsque certaines actions ne doivent pas être annulées, même si une erreur se produit dans la transaction parente.

Une transaction hors ligne a le même niveau d’isolation que la transaction parente. Toute exception levée ou soulevée dans le bloc de code d’une transaction hors ligne entraînera le retour en arrière de la transaction hors ligne et l’annulation de toutes les modifications apportées. Si le code est exécuté avec succès, la transaction hors ligne sera acquittée.

Gestion des transactions.

Envoi d’un événement (message) aux applications clientes.

PSQL

L’instruction POST_EVENT rapporte l’événement au gestionnaire d’événements, qui le stocke dans la table des événements. Lorsque la transaction est acquittée, le gestionnaire d’événements informe les applications qui attendent l’événement.

Le nom de l’événement est une sorte de code ou de message court, à vous de choisir, car il s’agit simplement d’une chaîne de caractères d’une longueur maximale de 127 octets.

Le nom de l’événement peut être une chaîne littérale, une variable ou toute expression SQL valide.

Retourner une valeur à partir d’une fonction stockée

PSQL

L’instruction RETURN termine la fonction et renvoie la valeur de l’expression value.

RETURN ne peut être utilisé que dans les fonctions PSQL (fonctions stockées et locales).

Voir. Exemples CREATE FUNCTION

Dans Firebird, il y a des Instructions PSQL pour gérer les erreurs et les exceptions dans les modules. Il y a de nombreuses exceptions intégrées qui se produisent lorsque des erreurs standard se produisent dans les instructions DML et DDL.

Une exception est un message qui est généré lorsqu’une erreur se produit.

Toutes les exceptions traitées par Firebird ont des valeurs numériques (caractères) prédéfinies pour les variables de contexte et les textes de message associés. Les messages d’erreur sont écrits en anglais par défaut. Il existe également des versions localisées de la base de données dans lesquelles les messages d’erreur sont traduits dans d’autres langues.

Vous trouverez une liste complète des exceptions du système dans l’annexe. "Traitement des erreurs, codes et messages":

Les exceptions personnalisées peuvent être déclarées comme des objets persistants dans la base de données et peuvent être appelées à partir du code PSQL pour signaler une erreur lorsque certaines règles de gestion sont violées.Le texte d’une exception personnalisée est limité à 1021 octets.Voir CREATE EXCEPTION pour plus de détails.

Dans le code PSQL, les exceptions sont traitées par l’Instruction WHEN.Si l’exception est gérée dans votre code, vous fournissez un correctif ou une solution de contournement et permettez à l’exécution de se poursuivre, aucun message d’exception n’est renvoyé au client.

L’exception entraîne l’arrêt de l’exécution dans le bloc.Au lieu de passer l’exécution à l’instruction finale END, la procédure remonte maintenant les niveaux dans les blocs imbriqués, en commençant par le bloc où l’erreur a été levée, et va dans les blocs externes pour trouver le code du gestionnaire qui connait l’exception.Il cherche la première instruction WHEN qui peut gérer cette erreur.

Déclencher une exception personnalisée ou rappeler une exception.

PSQL

L’Instruction EXCEPTION lance une exception personnalisée avec un nom spécifié. Lorsque vous lancez une exception, vous pouvez également spécifier un texte de message alternatif pour remplacer le texte de message spécifié lors de la création de l’exception.

Le texte du message d’exception peut contenir des emplacements de paramètres qui sont remplis lorsque l’exception est levée.La clause USING est utilisée pour passer des valeurs de paramètres dans l’exception.Les paramètres sont évalués de gauche à droite.Chaque paramètre est transmis à l’instruction qui lève l’exception sous la forme `N-y', N commençant par 1 :

L’exception peut être traitée par l’Instruction WHEN …​ DO.Si une exception utilisateur n’a pas été traitée dans un déclencheur ou une procédure stockée, les actions effectuées dans cette procédure stockée (déclencheur) sont annulées et le programme appelant reçoit le texte spécifié lors de la création de l’exception ou un autre texte de message.

Dans le bloc de traitement des exceptions (et uniquement dans celui-ci), vous pouvez rappeler une exception ou une erreur capturée en appelant l’instruction EXCEPTION sans paramètres. En dehors du bloc d’exception, un tel appel n’a aucun effet.

CREATE EXCEPTION, WHEN …​ DO.

Traitement des erreurs.

PSQL

Le WHEN …​ DO est utilisé pour gérer les situations d’erreur et les exceptions de l’utilisateur.L’Instruction intercepte toutes les erreurs et les exceptions utilisateur énumérées après le mot-clé WHEN.Si le mot clé ANY est spécifié après le mot clé WHEN, l’Instruction intercepte toutes les erreurs et les exceptions utilisateur, même si elles ont déjà été traitées dans le bloc WHEN ci-dessus.

Le WHEN …​ DO doit se trouver à la toute fin du bloc d’instructions, avant l’instruction END.

Le mot-clé DO est suivi d’une instruction composée où une erreur ou une exception peut être traitée.Une instruction composée est une instruction ou un bloc d’instructions entouré de crochets Instructions BEGIN et END.Les variables contextuelles sont disponibles dans cette déclaration GDSCODE, SQLCODE, SQLSTATE.Pour récupérer le nom d’une exception utilisateur active ou le texte d’un message d’erreur interprété, vous pouvez utiliser la fonction systèmeRDB$ERROR.Un Instruction de rappel en cas d’erreur ou de situation exceptionnelle est également disponible dans ce bloc.EXCEPTION (aucun paramètre).

Le WHEN …​ IF l’instruction est exécutée (même si aucune action n’y a été effectuée), une erreur ou une exception utilisateur n’interrompt pas ou n’annule pas l’action du déclencheur ou de la procédure stockée où cette instruction a été émise, l’opération se poursuit comme si aucune situation exceptionnelle ne s’était produite.Toutefois, dans ce cas, l’instruction DML (SELECT, INSERT, UPDATE, DELETE, MERGE) qui a provoqué l’erreur sera annulée et toutes les instructions suivantes du même bloc d’instructions ne seront pas exécutées.

L’Instruction intercepte les erreurs et les exceptions dans le bloc d’instructions en cours. Il intercepte également les situations similaires dans les blocs imbriqués si ces situations n’ont pas été traitées dans ceux-ci.

Le WHEN …​ DO voit toutes les modifications apportées avant l’énoncé causant l’erreur. Cependant, si vous essayez de les enregistrer dans une transaction hors ligne, ces modifications ne seront pas disponibles parce qu’au moment où la transaction hors ligne commence, la transaction dans laquelle ces modifications ont eu lieu n’est pas confirmée.

Instruction EXCEPTION,Codes d’erreur SQLSTATE et leurs descriptions,Codes d’erreur GDSCODE et SQLCODE et leurs descriptions.

Annonce du curseur.

PSQL

La commande DECLARE …​ CURSOR FOR déclare un curseur nommé, le liant au jeu de données obtenu dans l’instruction SELECT spécifiée dans la clause CURSOR FOR. Le curseur peut alors être ouvert, utilisé pour contourner le jeu de données résultant, et être refermé. Les mises à jour et suppressions positionnées sont également supportées en utilisant WHERE CURRENT OF dans les instructions UPDATE et DELETE.

Le nom du curseur peut être utilisé comme référence au curseur en tant que variable de type d’enregistrement. L’enregistrement courant est accessible via le nom du curseur, ce qui rend inutile la clause INTO dans l’instruction FETCH.

Les curseurs peuvent être défilables unidirectionnellement. La clause optionnelle SCROLL rend le curseur bidirectionnel (défilable), la clause NO SCROLL le rend unidirectionnel. Par défaut, les curseurs sont unidirectionnels.

Les curseurs unidirectionnels permettent uniquement un déplacement vers l’avant dans un ensemble de données, tandis que les curseurs bidirectionnels permettent non seulement un déplacement vers l’avant mais aussi vers l’arrière dans un ensemble de données et N positions par rapport à la position actuelle.

OPEN,FETCH,CLOSE,FOR SELECT.

Déclaration et mise en œuvre d’une sous-procédure.

PSQL

L’Instruction DECLARE PROCEDURE déclare ou implémente une sous-procédure.

Les restrictions suivantes sont imposées à une sous-procédure :

Un sous-programme peut appeler un autre sous-programme, y compris de manière récursive.Dans certains cas, il peut être nécessaire de déclarer au préalable un sous-programme.Règle générale : un sous-programme peut appeler un autre sous-programme si ce dernier est déclaré au-dessus du point d’appel.Tous les sous-programmes déclarés doivent être mis en œuvre avec la même signature.Les valeurs par défaut des paramètres des sous-programmes ne peuvent pas être remplacées.Cela signifie qu’ils ne peuvent être définis que dans l’implémentation de sous-programmes qui n’ont pas été déclarés auparavant.

DECLARE FUNCTION,CREATE PROCEDURE.

Déclaration et mise en œuvre d’une sous-fonction.

PSQL

L’Instruction DECLARE FUNCTION déclare une sous-fonction.

Les restrictions suivantes sont imposées au sous-programme :

Un sous-programme peut appeler un autre sous-programme, y compris de manière récursive.Dans certains cas, il peut être nécessaire de déclarer au préalable un sous-programme.Règle générale : un sous-programme peut appeler un autre sous-programme si ce dernier est déclaré au-dessus du point d’appel.Tous les sous-programmes déclarés doivent être mis en œuvre avec la même signature.Les valeurs par défaut des paramètres des sous-programmes ne peuvent pas être remplacées.Cela signifie qu’ils ne peuvent être définis que dans l’implémentation de sous-programmes qui n’ont pas été déclarés auparavant.

DECLARE PROCEDURE,CREATE FUNCTION.

La désignation d’un Instruction composé.

PSQL.

Les parenthèses de l’Instruction BEGIN …​ END définit une instruction composée ou un bloc d’instructions qui est exécuté comme une seule unité de code.Chaque bloc commence par l’Instruction BEGIN et se termine par l’Instruction END.Les blocs peuvent être imbriqués.La profondeur maximale est limitée à 512 niveaux de blocs imbriqués.Une instruction composée peut être vide, ce qui permet de l’utiliser comme un stub pour éviter d’écrire des instructions factices.

Il n’y a pas de point-virgule après les Instructions BEGIN et END.Toutefois, l’utilitaire de ligne de commande isql exige que la dernière instruction END de la définition du module PSQL soit suivie du caractère de terminaison défini par la commande SET TERM.Le terminateur ne fait pas partie de la syntaxe PSQL.

La dernière instruction END du déclencheur termine le déclencheur.La dernière instruction END d’une procédure stockée fonctionne en fonction du type de procédure :

Exemple de procédure à partir de la base de données employee.fdb, démontrant une utilisation simple des blocs BEGIN …​ END:

EXIT, LEAVE, SET TERM.

Une transition conditionnelle.

PSQL

L’Instruction conditionnel IF est utilisé pour exécuter un processus de branchement de données dans PSQL. Si la condition retourne TRUE, un Instruction composé est exécuté ou après le mot clé THEN. Sinon (si la condition retourne FALSE ou UNKNOWN), un Instruction composé est exécuté après le mot clé ELSE, s’il est présent. La condition est toujours entre parenthèses.