Artigos .NET Parâmetro de saída - Stored Procedures em PL/SQL

1. Introdução

Os parâmetros de saída são utilizados pelas procedures para que o aplicativo que a chamou possa obter as informações computadas pela mesma - seja esse aplicativo o SQL*Plus ou um programa desenvolvido em qualquer linguagem, como PHP, Delphi, Java, etc. A palavra chave OUT é utilizada para indicar à linguagem PL/SQL que o parâmetro é direcionado para saída.

Artigo: Estrutura

2. Criação de Stored Procedure com parâmetro de saída (OUT)

O código abaixo cria uma procedure PL/SQL chamada “p_esfera” que recebe o raio de uma esfera em um parâmetro de entrada, computa o volume da mesma e retornar este valor computado em um parâmetro de saída.

Listagem 1: Stored Procedure “p_esfera”


CREATE OR REPLACE PROCEDURE p_esfera(r IN NUMBER, 
                                     V OUT NUMBER) IS

/* -----------------------------------------------------------
   PROCEDURE : p_esfera
   DESCRIÇÃO : recebe como entrada o raio de uma esfera e retorna
               o volume na saída.
   PARÂMETROS: r -> ENTRADA. Valor do raio da esfera
               V -> SAÍDA. Volume calculado da esfera 
   ----------------------------------------------------------- */


PI CONSTANT NUMBER := 3.14;  -- declaração da constante “PI”

BEGIN 

  -- volume da esfera: 4/3 * pi * r ao cubo
  V := 4 / 3 * PI * (r * r * r); 

END p_esfera;
/

Note que a criação de um procedimento com parâmetro de saída não apresenta nenhuma novidade, excetuando o uso da palavra reservada OUT. No entanto, a execução da procedure no SQL*Plus requer um passo adicional. É preciso executá-la através do que chamamos de “bloco anônimo de código PL/SQL”.

Um bloco anônimo é um trecho livre de código digitado no SQL*Plus que não é transformado em procedimento ou função e que, por isso, não fica gravado em banco (ele “morre” logo após ser executado). O bloco anônimo é normalmente utilizado apenas quando queremos testar um programa via SQL*Plus.

A seguir apresenta-se um exemplo de bloco anônimo para o teste de nossa procedure “p_esfera”. Inicialmente é preciso usar o comando DECLARE para especificarmos as variáveis que serão utilizadas como parâmetros de entrada e saída da procedure. Em seguida, a chamada do procedimento e a impressão do conteúdo das variáveis é realizada dentro de um bloco delimitado por BEGIN e END.

Listagem 2: Execução de “p_esfera” no SQL*Plus



DECLARE 
   vRaio   NUMBER;
   vVolume NUMBER;

BEGIN
    
    vRaio := 10;

    p_esfera(vRaio,vVolume); -- chamada da procedure
    
    -- imprime o conteúdo das variáveis 
    DBMS_OUTPUT.PUT_LINE('Raio e Volume da Esfera:');
    DBMS_OUTPUT.PUT_LINE(vRaio);
    DBMS_OUTPUT.PUT_LINE(vVolume);
END;
/

Raio e Volume da Esfera:
10
4186,66666666666666666666666666666666666

Procedimento PL/SQL concluído com sucesso.

SQL>

Um bloco anônimo de código PL/SQL é um recurso usado no SQL*Plus quase sempre com a finalidade de fazer teste e depuração de programas PL/SQL. Ele não fica armazenado no banco.

Ambientes de programação como .NET, Java, PHP e outras, utilizam componentes de software para possibilitar a execução de stored procedures. Estes componentes oferecem opções para a configuração de parâmetros de entrada e saída (ex: um parâmetro de saída retornado pelo Oracle é automaticamente associado a uma variável .NET).

Bom assim finalizo este artigo, um abraço e até o próximo