Uma Function em um banco de dados é muito similar a uma função em uma linguagem de programação comum, podendo até mesmo ser criada com uma linguagem de programação como Java, para os bancos de dados Oracle e IBM DB2 ou uma rotina CLR para o banco de dados MSSQL, entretanto possuem varias diferenças entre os diferentes bancos de dados.
Uma Function padrão pode ser do tipo Escalar que normalmente retorna um valor ou pode ser do tipo Tabela, que retorna uma tabela, porem dependendo do banco de dados utilizado, podem existir vários outros tipos de retornos ou também de funções, por este motivo é recomendado que você acesse os links oficiais a seguir para saber mais detalhes sobre as funções:
Oracle: Create Function
O programa abaixo é muito similar ao programa anterior que cria uma trigger, porem o calculo do campo SLIQUIDO é efetuado através de uma função do mesmo nome, na query que retorna o set de dados para a grade, você pode notar que esta função possui uma sintaxe muito semelhante as funções ou métodos do qual você já está acostumado, exceto pelo banco de dados MSSQL que necessita que o proprietário da função seja declarado antes do nome da função.
Exemplo:
Neste exemplo utilizamos uma simples função escalar para efetuar um calculo e retornar um valor, utilize o script abaixo para criar os objetos necessários para cada banco de dados ou o banco de dados da sua preferencia.
SQL
Oracle
create table Funcionarios(
ID_Funcionario NUMBER(5),
Nome VARCHAR2(30),
Sobrenome VARCHAR2(70),
Cargo VARCHAR2(30),
Salario NUMBER(9,2));
-- Cria Funcionarios
Insert into FUNCIONARIOS values (1,'Steve','Gates','Programador',2550.56);
Insert into FUNCIONARIOS values (2,'Bill','Jobs','Diretor',5143.71);
Insert into FUNCIONARIOS values (3,'Wozniak','Gates','Desenvolvedor', 4389.21);
-- Cria tabela com a porcentagem de descontos
Create table DESCONTO (
ID_FUNCIONARIO NUMBER,
PORCENTAGEM NUMBER(9,2));
-- Cria tabela de lançamentos de descontos
Create table SALARIO (
ID_FUNCIONARIO NUMBER,
DATA_LANC DATE,
VDESCONTO NUMBER(9,2));
-- Deleta dados antigos
-- Caso utlizou exemplos anteriores
delete from desconto;
delete from salario;
-- Cria trigger na tabela Desconto
create or replace TRIGGER DESCONTO_INSERT
BEFORE INSERT ON DESCONTO
FOR EACH ROW
-- Declara variáveis
DECLARE pID NUMBER;
pSalario NUMBER(9,2);
pPorcentagem NUMBER(9,2);
BEGIN
-- Alimenta variáveis com os valores a serem inseridos
pID := :new.ID_FUNCIONARIO;
pPorcentagem := :new.PORCENTAGEM;
-- Seleciona Salario do funcionario corrente
Select SALARIO INTO pSalario FROM FUNCIONARIOS
WHERE ID_FUNCIONARIO = pID;
-- insere na tabela de lançamentos de salario
Insert into SALARIO
values (
pID,
SYSDATE,
(pSalario * pPorcentagem)/100);
END DESCONTO_INSERT;
-- Cria Função
Create or replace function
sLiquido(sal IN NUMBER, vdesc IN NUMBER)
RETURN NUMBER IS resultado NUMBER (9,2);
BEGIN
resultado := sal - vdesc;
return (resultado);
END;
Python
#!/usr/bin/env python
# -*- coding: latin-1 -*-
# Desenvolvimento Aberto
# FunctionOracle.py
# importa modulos
import wx
import wx.grid
import cx_Oracle
# Cria classe generica de uma WX.Grid
# A classe abaixo faz parte da documentação WXPython oficial
# Este trecho de código é util para manipular a grade
class GenericTable(wx.grid.PyGridTableBase):
def __init__(self, data, rowLabels=None, colLabels=None):
wx.grid.PyGridTableBase.__init__(self)
self.data = data
self.rowLabels = rowLabels
self.colLabels = colLabels
def GetNumberRows(self):
return len(self.data)
def GetNumberCols(self):
return len(self.data[0])
def GetColLabelValue(self, col):
if self.colLabels:
return self.colLabels[col]
def GetRowLabelValue(self, row):
if self.rowLabels:
return self.rowLabels[row]
def IsEmptyCell(self, row, col):
return False
def GetValue(self, row, col):
return self.data[row][col]
def SetValue(self, row, col, value):
pass
# Inicializa Grade
dados = []
colLabels = []
rowLabels = ("1", "2", "3", "4", "5", "6", "7", "8", "9", "10")
# Cria conexão
def conectarORA():
sconexao = "user/pa55w0rd@localhost/XE"
try:
con = cx_Oracle.connect(sconexao)
except ValueError:
tkMessageBox.showinfo(title="Menssagem", message="Erro de Conexão", parent=janela)
return con
# Executa e retorna SQL
def retornaTabelaORA(sql, con):
cursor = con.cursor()
cursor.execute(sql)
return cursor
def retornaDados(idfunc):
# Cria conexão
con = conectarORA()
# Envia dados a grid
sql = "Select A.ID_FUNCIONARIO, " + "A.NOME, " + " A.CARGO, " + \
" A.SALARIO, " + "B.PORCENTAGEM, " + "C.VDESCONTO, " + \
"C.DATA_LANC, " + \
"SLIQUIDO(A.SALARIO, C.VDESCONTO) AS SLIQUIDO " +\
"from FUNCIONARIOS A, DESCONTO B, SALARIO C " + "Where " + \
"A.ID_FUNCIONARIO = B.ID_FUNCIONARIO AND " + \
"A.ID_FUNCIONARIO = C.ID_FUNCIONARIO AND " + \
"A.ID_FUNCIONARIO = " + idfunc
# retorna set de dados
tabela = retornaTabelaORA(sql, con)
# Retorna metadados da tabela
for i in range(0, len(tabela.description)):
colLabels.append(tabela.description[i][0])
# Executa um fecth em todos os registros
resultado = tabela.fetchall()
# Popula dados
for conteudo in resultado:
dados.append(conteudo)
# Cria classe da grid
class SimpleGrid(wx.grid.Grid):
def __init__(self, parent):
wx.grid.Grid.__init__(self, parent, -1, pos=(5,90), size=(850,200))
# Cria formulario
class TestFrame(wx.Frame):
def __init__(self, parent):
wx.Frame.__init__(self, parent, -1, "Desenvolvimento Aberto - Functions - Python", size=(900, 350))
panel = wx.Panel(self, wx.ID_ANY)
label = wx.StaticText(panel, -1, label='Oracle Database - Function ->', pos=(300,10))
lfuncionario = wx.StaticText(panel, -1, label='Cod funcionario:', pos=(20,50))
self.funcionario = wx.TextCtrl(panel, size=(100, -1), pos=(120,50))
lporcentagem = wx.StaticText(panel, -1, label='Porcentagem (%):', pos=(260,50))
self.porcentagem = wx.TextCtrl(panel, size=(100, -1), pos=(360,50))
botao = wx.Button(panel, label="Inserir", pos=(480,50))
botao.Bind(wx.EVT_BUTTON, self.botaoInserir)
self.grid = SimpleGrid(panel)
#Insere dados e dispara trigger
def botaoInserir(self,event):
# Conecta e cria um cursor
con = conectarORA()
cursor = con.cursor()
# Insere clausula SQL
sql = "insert into DESCONTO VALUES (" + self.funcionario.GetValue() + ", " + self.porcentagem.GetValue() + ")";
# Executa e comita a transação
cursor.execute(sql)
con.commit()
# Retorna set de dados
retornaDados(self.funcionario.GetValue())
# Limpa grade
self.grid.ClearGrid()
# Insere set de dados contidos em um tuplas
tableBase = GenericTable(dados, rowLabels, colLabels)
self.grid.SetTable(tableBase)
# Atualiza grade
self.grid.ForceRefresh()
# Inicializa a aplicação
app = wx.PySimpleApp()
frame = TestFrame(None)
frame.Show(True)
app.MainLoop()


