Comment ajouter une valeur à un compteur dans une procédure PL/SQL
Les procédures en PL/SQL sont des blocs de code nommés qui encapsulent la logique métier et peuvent être exécutés à tout moment. Contrairement aux fonctions, les procédures ne renvoient pas directement une valeur mais peuvent modifier les données à l’aide des paramètres OUT. Une procédure stockée Oracle est un sous-programme PL/SQL nommé, compilé et enregistré dans le dictionnaire de données Oracle.
Concepts clés : compteur, variable et portée
Les variables déclarées en interne à une procédure sont innaccessibles de l'extérieur de celle-ci. La portée ou visibilité d'une variable est limitée au bloc PL/SQL dans laquelle elle est déclarée. Seuls les mots clés IF et END IF; sont obligatoires. Un curseur est paramétrable. La portée des variables et leur initialisation sont des éléments essentiels lors de la manipulation d'un compteur.
Déclaration d’un compteur dans une procédure
Utilisez %TYPE et %ROWTYPE pour déclarer vos variables et paramètres. PL/SQL n'est pas sensible à la casse. Par exemple, pour déclarer un compteur local :
DECLARE compteur NUMBER := 0; -- ou dans la section DECLARE d'une procédure
Il est souvent recommandé d'initialiser explicitement la variable compteur lors de sa déclaration pour éviter des comportements inattendus. La déclaration et l'initialisation garantissent une valeur définie au démarrage de la procédure.
Lire aussi: Ajout manuel de données dans les compteurs Domoticz
Ajouter une valeur au compteur : opérations simples
Pour incrémenter un compteur, on utilise des affectations simples. Exemple d'opérations : compteur := compteur + 1; ou compteur := compteur + p_increment; où p_increment est un paramètre IN de la procédure. Seuls les mots clés IF et END IF; sont obligatoires pour les structures conditionnelles entourant ces opérations si nécessaire.
Exemple pratique : procédure qui augmente un compteur
Voici un exemple typique intégré dans une structure de procédure Oracle. Une procédure stockée Oracle est un sous-programme PL/SQL nommé, compilé et enregistré dans le dictionnaire de données Oracle.
CREATE OR REPLACE PROCEDURE incrementer_compteur(p_increment IN NUMBER DEFAULT 1, p_result OUT NUMBER) ISBEGIN DECLARE compteur NUMBER := 0; BEGIN compteur := compteur + p_increment; p_result := compteur; END;EXCEPTION WHEN OTHERS THEN RAISE_APPLICATION_ERROR(-20001, 'Erreur lors de l''incrémentation du compteur');END;
Cette structure illustre l'usage de paramètres IN (p_increment) et OUT (p_result). Les paramètres des procédures PL/SQL définissent la façon dont les valeurs sont transmises entre l’appelant et la procédure. DANS (Faire défaut): Utilisé pour les paramètres d’entrée uniquement. DEHORS: Utilisé pour retourner une valeur de la procédure à l’appelant. À L’INTÉRIEUR À L’EXTÉRIEUR: Permet à la fois l’entrée et la sortie.
Conserver la valeur du compteur entre appels
Si vous avez besoin de préserver un compteur entre les appels, la variable locale ne suffit pas car elle est réinitialisée à chaque exécution. Pour un état persistant, utilisez :
Lire aussi: Modifier Activité Kbis Auto-Entrepreneur
- Une table dédiée (ex. table_counters) et une mise à jour via UPDATE ... SET compteur = compteur + n;
- Une variable package avec une portée session si la durée de vie souhaitée est la session courante.
Exemple d'approche table :
CREATE OR REPLACE PROCEDURE ajouter_au_compteur_table(p_name IN VARCHAR2, p_inc IN NUMBER DEFAULT 1) ISBEGIN UPDATE table_counters SET valeur = valeur + p_inc WHERE nom = p_name; IF SQL%ROWCOUNT = 0 THEN INSERT INTO table_counters(nom, valeur) VALUES (p_name, p_inc); END IF;EXCEPTION WHEN OTHERS THEN RAISE_APPLICATION_ERROR(-20002, 'Erreur mise à jour compteur en table');END;
Parcours de jeux de données et incrémentation conditionnelle
Lors du traitement de jeux de données volumineux, le fait de parcourir les enregistrements individuellement ralentit les performances en raison des changements fréquents de contexte entre SQL et les moteurs PL/SQL. Une technique classique consiste à utiliser un curseur pour parcourir les lignes et incrémenter un compteur selon une condition.
Déclaration du curseur et boucle :
DECLARE cursor_product CURSOR FOR SELECT ...;LOOP FETCH cursor_product INTO ... EXIT WHEN cursor_product%NOTFOUND; -- logique : si condition alors compteur := compteur + 1;END LOOP;
Lire aussi: INPI et Micro-Entreprise : Démarches
CURSOR : curseur de base de données. Permet de parcourir une table et d'effectuer des traitements sur les enregistrements. Cette procédure parcourt les enregistrements d'un curseur.
Gestion des erreurs lors de l’incrémentation
Lorsque vous travaillez avec PL/SQL, les erreurs sont inévitables. Ceux-ci peuvent être dus à des violations de contraintes, à des problèmes d’intégrité des données ou à des erreurs d’exécution. PL/SQL fournit une manière structurée de gérer les erreurs à l’aide du bloc EXCEPTION. Les erreurs doivent être interceptées avec le mot clé WHEN suivi du code erreur ciblé.
EXCEPTION WHEN OTHERS THEN RAISE_APPLICATION_ERROR(-20003, 'Erreur générale…');
Erreur : PLS-00905 : object is invalid ou procédure compilée avec des warnings. Sous SQL*Plus ou SQL Developer, vous pouvez également utiliser la commande SHOW ERRORS PROCEDURE nom_procedure; immédiatement après la création.
Bonnes pratiques et optimisation
- Utilisez %TYPE et %ROWTYPE pour déclarer vos variables et paramètres afin d'assurer la compatibilité des types.
- Préférez les opérations SET / UPDATE en SQL pour incrémentations massives plutôt que boucles individuelles quand c'est possible.
- Pour des traitements volumineux, considérez les fonctions en pipeline pour optimiser l'utilisation de la mémoire.
- La surcharge permet à plusieurs procédures d’avoir le même nom mais des listes de paramètres différentes, améliorant la lisibilité et réduisant la duplication de code.
- Utilisez AUTHID DEFINER pour la sécurité lorsque c'est pertinent.
Exemples supplémentaires et cas d’usage
Exemple 1 - Mise à jour du compteur lié à un événement métier : Avant insertion dans la table gc_acheter, on compte le nombre d'articles produits avec le numéro de l'article à acheter. Un trigger est un objet associé à une table et est déclenché lorsqu'un événement intervient sur celle-ci. Exemple d'usage : Recalculer le montant du CA d'un client lors de l'enregistrement d'une facture.
Exemple 2 - Journalisation d'activité avec compteur : Cette procédure enregistre l’activité de l’utilisateur dans l’activité_table de journal. Il accepte deux paramètres d’entrée : p_user pour le nom d’utilisateur et p_action pour l’activité effectuée. On peut conserver un compteur du nombre d'actions réalisées par utilisateur en mettant à jour une table de statistiques.
Table récapitulative : méthodes pour ajouter une valeur à un compteur
| Méthode | Portée | Avantages | Inconvénients |
|---|---|---|---|
| Variable locale dans procédure | Exécution | Simple, rapide pour usage temporaire | Perdue après l'appel |
| Table dédiée (UPDATE/INSERT) | Persistante | Persiste entre appels, supporte concurrence | Verrouillages/performances si mal conçue |
| Variable de package | Session | Conserve état pendant la session | Non persistante entre sessions |
| Trigger + table | Transaction | Automatique lors d'événements DML | Complexité et coûts si appels massifs |
Rappels utiles
- Une transaction est une séquence d'opérations exécutées en tant qu’unité logique unique de travail.
- DBMS_OUTPUT.PUT_LINE permet de générer une ligne entière dans le tampon pour debug.
- ALTER PROCEDURE nom COMPILE; permet la recompilation. DROP PROCEDURE nom; supprime la procédure.
balises:
