{"id":3310,"date":"2019-03-25T17:43:41","date_gmt":"2019-03-25T20:43:41","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/linguagem-sql-capitulo-9-stored-procedures\/"},"modified":"2019-05-27T14:46:21","modified_gmt":"2019-05-27T17:46:21","slug":"linguagem-sql-capitulo-9-stored-procedures","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/linguagem-sql-capitulo-9-stored-procedures\/","title":{"rendered":"Linguagem SQL: Cap\u00edtulo 9 – Stored Procedures."},"content":{"rendered":"
\n

Uma stored procedure (procedimento armazenado) \u00e9 um conjunto de instru\u00e7\u00f5es desenvolvidas em linguagem T-SQL (Transact-Sql) que, quando armazenadas ou salvas, ficam dentro do servidor de forma pr\u00e9-compilada. Esse procedimento armazenado no banco de dados (Servidor) pode ser chamado a qualquer momento, tanto pelo sistema gerenciador de banco de dados (SGBD) quanto por uma aplica\u00e7\u00e3o que utilize o Elipse E3.<\/p>\n

O uso de stored procedures \u00e9 uma importante contribui\u00e7\u00e3o relacionada ao uso de um banco de dados, proporcionando um melhor desempenho nas aplica\u00e7\u00f5es.<\/p>\n

O objetivo deste artigo \u00e9 demonstrar uma simples utiliza\u00e7\u00e3o de uma stored procedure em conjunto com o E3. O banco de dados utilizado neste exemplo foi o Microsoft SQL Server 2012.<\/p>\n


\nCriando uma stored procedure com passagem de par\u00e2metro de entrada<\/b><\/p>\n

O primeiro passo ser\u00e1 criar uma tabela no banco de dados para posterior utiliza\u00e7\u00e3o da stored procedure:<\/p>\n

CREATE TABLE<\/span> <\/span>tbl_teste<\/span><\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 (<\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 user_cpf<\/span> int <\/span>not null primary key<\/span>,<\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 user_nome<\/span> varchar<\/span>(128) not null,<\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 user_email<\/span> varchar<\/span>(128) not null<\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 )<\/span>
\nGO<\/span><\/div>\n

No exemplo abaixo, ser\u00e1 criada uma stored procedure com passagem de par\u00e2metros, onde ser\u00e1 informado o n\u00famero do CPF como par\u00e2metro de entrada. O procedimento armazenado retornar\u00e1 o seguinte resultado:<\/p>\n

— CRIA A STORED PROCEDURE<\/span>
\nCREATE PROCEDURE<\/span> cadastroCPF_SELECT<\/span><\/span>
\n— PAR\u00c2METRO DE ENTRADA, NESTE EXEMPLO O N\u00daMERO DO CPF<\/span>
\n@CPF<\/span> int<\/span><\/span>
\nAS<\/span>
\n— COMANDO T-SQL PARA OBTER RESULTADO<\/span>
\nSELECT <\/span>* FROM <\/span>tbl_teste<\/span> <\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 WHERE <\/span>user_cpf = @CPF<\/span><\/span>
\nGO<\/span><\/div>\n

A figura abaixo mostra o comando para executar a stored procedure. O n\u00famero informado ao lado da instru\u00e7\u00e3o (998958889) \u00e9 o par\u00e2metro de entrada:<\/p>\n

\"\"
\nFigura 1:<\/b> Comando Execute<\/span><\/div>\n

Ap\u00f3s a stored procedure ter sido criada e configurada no banco de dados, e necess\u00e1rio execut\u00e1-la atrav\u00e9s do E3. Primeiramente, insira um objeto Consulta, e logo em seguida habilite a edi\u00e7\u00e3o direta do SQL inserindo a seguinte linha:<\/p>\n

\"\"
\nFigura 2<\/b>: Execu\u00e7\u00e3o atrav\u00e9s do E3<\/span><\/div>\n

Este comando SQL executa a stored procedure enviando uma vari\u00e1vel como par\u00e2metro de entrada (<%entrada%><\/span>).<\/p>\n

Para enviar um valor de entrada e retornar o valor da consulta realizada pela stored procedure, insira o seguinte script no E3:<\/p>\n

\"\"
\nFigura 3:<\/b> Script inserido no E3<\/span><\/div>\n

Criando uma stored procedure com passagem de par\u00e2metro de entrada e retorno de sa\u00edda<\/b><\/p>\n

O primeiro passo ser\u00e1 criar uma tabela no banco de dados para posterior utiliza\u00e7\u00e3o da stored procedure:<\/p>\n

CREATE TABLE<\/span> COLABORADORES<\/span><\/span>
\n(<\/span>
\nCODIGO <\/span>varchar<\/span>(5),<\/span>
\nNOME <\/span>varchar<\/span>(80),<\/span>
\nDEPARTAMENTO <\/span>int<\/span>,<\/span>
\nSALARIO <\/span>money<\/span><\/span>
\n)<\/span>
\nGO<\/span><\/div>\n

No exemplo abaixo, ser\u00e1 criada uma stored procedure com passagem de par\u00e2metros de entrada e de retorno; neste caso, ser\u00e1 necess\u00e1rio informar uma vari\u00e1vel tipo OUTPUT. Esta stored procedure envia um par\u00e2metro de entrada como crit\u00e9rio de sele\u00e7\u00e3o para recuperar a soma dos sal\u00e1rios da tabela COLABORADORES atrav\u00e9s de um par\u00e2metro de sa\u00edda.<\/p>\n

CREATE PROCEDURE <\/span>Salario_Depto <\/span><\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 (@DEPTO<\/span> int<\/span>,<\/span>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 @SOMA<\/span> money OUTPUT<\/span>) AS<\/span><\/span>
\nBEGIN<\/span>
\nSELECT <\/span>@SOMA<\/span>=sum<\/span>(SALARIO<\/span>) FROM <\/span>COLABORADORES<\/span><\/span>
\nWHERE <\/span>DEPARTAMENTO = @DEPTO<\/span><\/span>
\nEND<\/span><\/div>\n

A execu\u00e7\u00e3o da stored procedure ser\u00e1 a seguinte:<\/p>\n

— Vari\u00e1vel de sa\u00edda<\/span>
\nDECLARE <\/span>@SALARIO_TOTAL<\/span> Money<\/span><\/span>
\n— Vari\u00e1vel para passagem de par\u00e2metro de entrada<\/span>
\nDECLARE <\/span>@DEPARTAMENTO<\/span> int<\/span><\/span>
\nSET <\/span>@DEPARTAMENTO<\/span> = 5<\/span>
\nEXEC <\/span>Salario_Depto @DEPARTAMENTO, @SALARIO_TOTAL<\/span> OUTPUT<\/span><\/span>
\nPRINT <\/span>@SALARIO_TOTAL<\/span><\/span><\/div>\n

Stored procedure enviando e recebendo par\u00e2metros atrav\u00e9s do E3:<\/p>\n

\"\"
\nFigura 4:<\/b> Execu\u00e7\u00e3o da SP atrav\u00e9s da Consulta do E3<\/span><\/div>\n

Executando a consulta, obt\u00e9m-se o seguinte resultado:<\/p>\n

\"\"
\nFigura 5<\/b>: Resultado da Consulta do E3 <\/span><\/div>\n

Para executar uma stored procedure do Oracle a partir do E3, \u00e9 necess\u00e1rio utilizar o comando call <\/i>no c\u00f3digo SQL da Consulta, e em seguida o nome da stored procedure com os devidos par\u00e2metros. Para executar o comando, utilize o m\u00e9todo Execute <\/i>da Consulta.<\/p>\n

Artigos Relacionados<\/h3>\n
\n