Neste exercício, você utiliza um assistente para criar um procedimento armazenado DB2 SQL. Este procedimento armazenado simples retorna informações do funcionário
da tabela EMP_EMPLOYEE_DIM quando o ID da organização do
funcionário corresponde a um valor que o usuário insere.
No assistente, selecione um modelo para usar como a base
para o código no procedimento armazenado. Neste exercício você cria
o modelo para selecionar no assistente. Para um procedimento armazenado simples
tal como aquele que foi criado neste exercício, você ordinariamente
usaria um dos modelos básicos. No entanto, você cria um modelo neste
exercício para que fique familiarizado com o processo de criação de
modelos.
Ao criar uma rotina no ambiente de trabalho, você salva o código-fonte
no espaço de trabalho do projeto.
Para criar um procedimento armazenado SQL:
- Crie um modelo a partir de um modelo existente.
- Clique em . A
janela Preferências é aberta.
- Expanda e, em seguida, clique em Modelos.
- Na página Modelos, role para baixo até ver o
primeiro modelo com o contexto db2luw_sp_sql. O Nome para este modelo é "Customizado: Você fornece o
SQL, retorna um conjunto de resultados."
- Clique no modelo e, em seguida, clique em Editar. A janela Editar Modelo é aberta.
- Substitua o nome do modelo existente pelo seguinte
texto: GSDB4tutorial: Instrução SEARCH do funcionário básica.
- Substitua a descrição do modelo existente pelo seguinte
texto: Retornar ID, nome e organização de todos os funcionários
na tabela EMP_EMPLOYEE_DIM.
- No padrão, exclua todas as linhas de comentário que são
limitadas pelas duas linhas de comentário com sinais de número (-- #################).
- Substitua [Seu SQL para executar vai aqui] pela
seguinte instrução SQL:
SELECT EMPLOYEE_CODE, FIRST_NAME,
LAST_NAME, ORGANIZATION_CODE
FROM EMP_EMPLOYEE_DIM;
O modelo concluído
contém as seguintes informações:
- Clique em OK na janela Editar
Modelo. Uma caixa de mensagens solicita
que você indique se deseja criar um modelo adicional
com o novo nome ou renomear o modelo existente.
- Clique em Sim para criar o novo modelo. Seu modelo é incluído na lista na página Modelos.
- Clique em OK na janela Preferências
- Na visualização Data Project Explorer, expanda o projeto SPDevelopment para localizar a pasta Procedimentos Armazenados.
- Clique com o botão direito na pasta Procedimentos Armazenados e,
em seguida, selecione . É aberto o assistente de Novo Procedimento Armazenado.
- No campo Nome, digite SPEmployee.
- No campo Linguagem, selecione SQL.
- Selecione o modelo GSDB4tutorial: Instrução SEARCH do funcionário básica e,
em seguida, clique em Concluir. O
assistente fecha e o procedimento armazenado é aberto no editor de rotina,
no qual é possível visualizar e editar o código de origem
Neste ponto, se você
salvou, implementou e executou o procedimento armazenado, os resultados mostrarão
todos os funcionários na tabela. No entanto, desejamos limitar os resultados
apenas àqueles funcionários que estão na organização 018.
- No editor, execute as seguintes ações:
- Inclua o parâmetro de entrada org na
declaração de procedimento para que a declaração seja conforme a seguir:
CREATE PROCEDURE SPEmployee ( IN org CHAR(6) )
- Exclua o ponto e vírgula que segue EMP_EMPLOYEE_DIM.
- Insira a cláusula de condição a seguir:
WHERE ORGANIZATION_CODE = org;
O procedimento armazenado concluído contém o código a seguir:
CREATE PROCEDURE SPEmployee ( IN org CHAR(6) )
DYNAMIC RESULT SETS 1
P1: BEGIN
-- Declare cursor
DECLARE cursor1 CURSOR WITH RETURN for
SELECT EMPLOYEE_CODE, FIRST_NAME,
LAST_NAME, ORGANIZATION_CODE
FROM EMP_EMPLOYEE_DIM
WHERE ORGANIZATION_CODE = org;
-- Cursor left open for client application
OPEN cursor1;
END P1
- Salve o procedimento armazenado e, em seguida, feche o editor da rotina.
O procedimento armazenado, SPEmployee, é exibido na visualização do Data
Project Explorer na pasta Procedimentos Armazenados
sob o projeto no qual você o criou. O procedimento armazenado está
pronto para ser implementado.