Introduction à DBMS_OUTPUT en PL/SQL¶

Qu’est-ce que DBMS_OUTPUT ?¶

Lorsqu’on développe en PL/SQL avec Oracle, il est souvent utile d’afficher des messages pour comprendre le comportement d’un programme, vérifier des valeurs ou faire du débogage.

Le package DBMS_OUTPUT permet d’afficher du texte depuis un bloc PL/SQL vers la console de l'outil de développement.

À quoi sert DBMS_OUTPUT ?

Il est principalement utilisé pour :

Afficher des messages de débogage
Suivre l’exécution d’un programme
Vérifier des valeurs de variables

Procédure principale : PUT_LINE¶

La procédure la plus utilisée est :

DBMS_OUTPUT.PUT_LINE('Votre message ici');

Elle affiche une ligne complète avec un retour à la ligne automatique.

Exemple simple

BEGIN
    DBMS_OUTPUT.PUT_LINE('Bonjour monde!');
END;
/

Exemple avec variable

DECLARE
    v_nom VARCHAR2(50) := 'Mélissa';
BEGIN
    DBMS_OUTPUT.PUT_LINE('Bonjour ' || v_nom || ' !');
END;
/

Utilisation de NEW_LINE¶

La procédure NEW_LINE permet d’ajouter un saut de ligne sans afficher de texte.

Exemple

BEGIN
    DBMS_OUTPUT.PUT_LINE('Ligne 1');
    DBMS_OUTPUT.NEW_LINE;
    DBMS_OUTPUT.PUT_LINE('Ligne 2');
END;
/

Résultat

Ligne 1

Ligne 2

⚠️ IMPORTANT : Activer l’affichage¶

Par défaut, les messages ne s’affichent pas et sont envoyés dans le buffer (espace mémoire).

Vous devez activer l’option suivante au début de votre fichier SQL pour que les messages soient envoyés à la console au lieu du buffer :

SET SERVEROUTPUT ON;

Exemple complet

SET SERVEROUTPUT ON;

BEGIN
    DBMS_OUTPUT.PUT_LINE('Test d''affichage');
END;
/

Sans cette commande, le code s’exécute, mais aucun message ne sera visible.

Bonnes pratiques¶

Utiliser DBMS_OUTPUT pour le débogage et l’apprentissage
Éviter son utilisation en production