Esse artigo foi escrito tendo como base o Banco de Dados MSSQLServer &KDPDQGR6WRUHG3URFHGXUHVDSDUWLUGR&ODULRQ

Tamanho: px

Começar a partir da página:

Download "Esse artigo foi escrito tendo como base o Banco de Dados MSSQLServer 2000. &KDPDQGR6WRUHG3URFHGXUHVDSDUWLUGR&ODULRQ"

Augusto Teixeira Vilaverde
8 Há anos
Visualizações:

1 ,QWURGXomR Esse artigo foi escrito tendo como base o Banco de Dados MSSQLServer &KDPDQGR6WRUHG3URFHGXUHVDSDUWLUGR&ODULRQ Para chamar uma Stored Procedure em Clarion, utilizamos a sentença Call, como já é de conhecimento de todos. Se quisermos passar parâmetros para esta Stored Procedure, devemos passá-los da mesma maneira como passamos em uma função do Clarion. Entretanto, se a Stored Procedure não retorna valor, usamos a sintaxe NORESULTCALL. Consideremos a seguinte Stored Procedure, em uma tabela CEP, cujo objetivo será incluir um registro na tabela. &ULDQGRD63QR%DQFR Para facilitar a vida do consulente criamos a Stored Procedure no banco Northwind, onde criamos também a tabela de CEP, por ser este banco padrão de instalação do SQL Server 2000 e já estar devidamente configurado. Abaixo o script da SP: CREATE PROCEDURE [varchar]8 AS INSERT INTO [Northwind].[dbo].[cep] [pais], [uf], [cidade], [bairro], [endereço],

Se quisermos passar parâmetros para esta Stored Procedure, devemos passá-los da mesma maneira como passamos em uma função do Clarion.

2 GO &KDPDQGRD6WRUHG3URFHGXUHDSDUWLUGR&ODULRQ Aproveitando as facilidades disponibilizadas pelo Construtor de Stored Procedures do SQL Server 2000, deixei os números dos parâmetros, para saber exatamente a ordem em que os parâmetros deverão ser passados para a SP. Um exemplo bem cretino: vw{prop:sql} = 'NORESULTCALL sp_inclui_cep''bra'',''pr'',''porto UNIÃO'',''SANTA ROSA'',''Rua Santa Rosa'','' ''' Onde, vw é a View de uma tabela chamada tabelasql, criada no Dicionário de dados para receber o record set do banco de dados. Em um aplicativo de exemplo, criamos uma janela com um controle Browse, que lista o conteúdo dos arquivos de CEP`. Utilizaremos este controle para exemplificar o uso das funções e procedimentos. Abaixo do controle List, temos um botão [HFXWDU63FRPSDUkPHWURVVHPUHWRUQR, onde fazemos a chamada para uma janela de parâmetros. Esta janela, cujo procedimento se chama -$1/$B3$5$07526 irá apresentar 6 controles do tipo entry cujos atributos XVH são variáveis locais, e naturalmente poderia ser campos de um formulário. O conteúdo de cada variável será passado como parâmetro

$Um exemplo bem cretino: vw{prop:sql} = 'NORESULTCALL sp_inclui_cep''bra'',''pr'',''porto UNIÃO'',''SANTA ROSA'',''Rua Santa Rosa'',''84600000''' Onde, vw é a View de uma tabela chamada tabelasql,$

3 para a SP VSBLQFOXLB&3que agora pertence ao banco 1RUWZKLQG. Na -$1/$B3$5$07526 temos um botão [HFXWDU 63 que se encarrega de executar a SP no banco, de acordo com a sintaxe de propriedades do Clarion. Então, no evento $FFHSWHG do nosso botão [HFXWDU 63 inserimos o seguinte código:!executando uma stored procedure sem retorno Openvw!Código cretino comentado!vw{prop:sql} = 'NORESULTCALL sp_inclui_cep 'BRA ', 'PR ', 'PORTO UNIÃO ', 'SANTA ROSA ', 'Rua Santa Rosa ', ' ''!Sentença SQL com os parâmetros locais vw{prop:sql} = 'NORESULTCALL sp_inclui_cep'&chr39&loc:pais&chr39&',' &chr39& LOC:uf&chr39&',' &chr39& LOC:cidade&chr39&',' &chr39& LOC:bairro&chr39&',' &chr39& LOC:endereco&chr39&',' &chr39& LOC:cep&chr39&'' nextvw Closevw Para que este código funcione, na área de dados Local Data do procedimento, precisamos declarar uma View para a tabela SQL que estamos usando. A tabela tabelasql, é uma tabela que criamos no nosso dicionário de dados para servir de buffer de retorno das nossas sentenças sql. Recomendamos o uso desta tabela por ser muito mais versátil que o uso de uma variável global como buffer, pois a tabela já é global, não precisa ser clareada a cada uso, e pode perfeitamente receber uma Visão view do banco de dados em cada uma das suas colunas cstring o cstring pode receber qualquer tipo de dado. Isto explicado, na janela -$1/$B3$5$07526, em /RFDO 'DWD, incluímos o seguinte código: vw viewtabelasql PROJECTTSQL:coluna1 PROJECTTSQL:coluna2 PROJECTTSQL:coluna3 PROJECTTSQL:coluna4 PROJECTTSQL:coluna5 PROJECTTSQL:coluna6 PROJECTTSQL:coluna7 PROJECTTSQL:coluna8 PROJECTTSQL:coluna9 PROJECTTSQL:coluna10 No código acima, criamos uma view da nossa tabelasql. Em seguida o código do botão!executando uma stored procedure sem retorno Openvw!Código cretino comentado

$vw{prop:sql} = 'NORESULTCALL sp_inclui_cep 'BRA ', 'PR ', 'PORTO UNIÃO ', 'SANTA ROSA ', 'Rua Santa Rosa ', '84600000 ''!$

4 !vw{prop:sql} = NORESULTCALL sp_inclui_cep BRA, PR, PORTO!UNIÃO ', 'SANTA ROSA ', 'Rua Santa Rosa ', ' ''!Sentença SQL com os parâmetros locais vw{prop:sql} = 'NORESULTCALL sp_inclui_cep'&chr39&loc:pais&chr39&',' &chr39&loc:uf&chr39&',' &chr39&loc:cidade&chr39&',' &chr39& LOC:bairro&chr39&',' &chr39& LOC:endereco&chr39&',' &chr39&loc:cep&chr39&'' nextvw Closevw Executa perfeitamente o nosso código cretino que está comentado cretino, por que o valor dos parâmetros é digitado no código fonte, e executa perfeitamente a sentença stored procedure tendo como parâmetro as variáveis locais. Como a SP não retorna nada, ao invés de &$// usamos 12568/7&$//. Ainda no botão [HFXWDU63FRPSDUkPHWURVVHPUHWRUQR no evento $FFHSWHG, colocamos o código abaixo: Parent.ResetTrue Essa linha, apenas atualiza a View do Browse, após executar a SP. Para o exemplo que retorna um valor da SP, desenvolvi um exemplo bastante simples, com o fito de facilitar o entendimento. Na verdade, minha intenção aqui é mostrar a técnica, que acredito uma vez dominada possa servir para vôos mais altos espero. Um dos requisitos para retornar um valor de uma SP é que o DBA ou o programador da Stored Procedure, informe no código da SP isto: Vejamos no nosso exemplo: CREATE PROCEDURE [int] OUTPUT AS BEGIN +@j_2 GO No nosso banco de dados 1RUWZKLQG criamos a sp_retorna_total No caso da sp de exemplo temos dois parâmetros de entrada que são passados para a SP, i_1 e j_2, ambos do tipo int. No SQL Server, os parâmetros de retorno devem ter o atributo OUTPUT, depois da qualificação de tipo, para que possam ser retornados da SP. O resto, é TRANSACT SQL. Agora, vamos ao código Clarion que pega este retorno da SP. No nosso browse, criamos outro botão chamado [HFXWD VS FRP UHWRUQR, esse vai executar uma ação para abrir a janela -$1/$B9$/256, que tem um botão cujo código que passa parâmetros para a store procedure VSBUHWRUQDB727$/ e vai receber o resultado desta. No evento $FFHSWHG do botão, incluímos o seguinte código:

LOC:endereco&chr39&',' &chr39&loc:cep&chr39&'' nextvw Closevw Executa perfeitamente o nosso código cretino que está comentado cretino, por que o valor dos parâmetros é digitado no código fonte, e

5 !Executando uma stored procedure com retorno BIND ValRet,ValorRetorno BIND Saida,Saida CHAMAPROCEDURE &ValRet = CALL sp_retorna_total &chr39&i&chr39&, &chr39&j&chr39&,&saida!pega o retorno da função e grava na variável t t = saída Foram criadas duas variáveis: ValorRetorno e Saída. Ambas as variáveis foram bindadas para que pudessem ser usadas na sentença SQL. Em seguida usamos uma local PROCEDURE para chamar a nossa store procedure e pegar o seu retorno. Para criar a Local Procedure, na área de dados do nosso procedimento, inserimos o seguinte código: MAP CHAMAPROCEDURESTRING Explicando, criamos uma LOCAL PROCEDURE, chamada CHAMAPROCEDURE, que recebe como argumento uma string, no caso a nossa string sql. No embed LOCAL PROCEDURES do nosso procedimento, inserimos o seguinte código: CHAMAPROCEDURE PROCEDURESTR Code tabelasql{prop:sql} = STR onde: STR -> é a nossa sentença SQL Tabelasql = é a nossa tabela de retorno ou buffer sql. Para finalizar, não esquecer da sentença Unbind no final do seu código.

Em seguida usamos uma local PROCEDURE para chamar a nossa store procedure e pegar o seu retorno.

Documentos relacionados

Projeto de Banco de Dados

Projeto de Banco de Dados Prof. Marcelo Siedler Objetivos do documento: Apresentar os conceitos de stored procedutes e funções. Exercícios. Referência: http://dev.mysql.com/doc/refman/4.1/pt/stored-procedures.html