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

A criação de módulos com parâmetros de saída (OUT) é o tema principal deste quarto artigo sobre stored procedures PL/SQL. Adicionalmente, o artigo descreve como realizar testes em procedures com o uso de blocos anônimos de código.

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

Artigos relacionados