< Anterior | Próximo >

Criando e Implementando um Procedimento Armazenado SQL

Neste exercício, você utiliza um assistente para criar um procedimento armazenado DB2 SQL. Esse procedimento armazenado simples retorna informações do funcionário da tabela EMPLOYEE quando o ID do departamento do funcionário corresponde a um valor digitado pelo usuário. Você utiliza outro assistente para criar a instrução SQL, embora também seja possível digitar a instrução diretamente no assistente que cria o procedimento armazenado.

Ao criar uma rotina no ambiente de trabalho, você salva o código-fonte no espaço de trabalho do projeto. Quando você implementa uma rotina, o ambiente de trabalho executa as ações a seguir:
  • Para rotinas Java, o código-fonte é compilado na estação de trabalho do cliente.
  • Para rotinas SQL, o código-fonte é compilado no servidor.
  • O código-fonte é copiado para o servidor DB2.
  • A rotina é registrada na tabela do catálogo.

Para criar e implementar um procedimento armazenado SQL:

  1. Na visualização Data Project Explorer, expanda o projeto SPDevelopment para localizar a pasta Procedimentos Armazenados.
  2. Clique com o botão direito do mouse na pasta Procedimentos Armazenados e selecione Novo > Procedimento Armazenado. É aberto o assistente de Novo Procedimento Armazenado.
  3. No campo Nome, digite SPEmployee.
  4. Mantenha a linguagem padrão, que é SQL.
  5. Clique em Avançar.
  6. Na página Instruções SQL, clique em Criar SQL. Esta ação ativa o assistente Nova Instrução SQL que o orienta na criação de uma instrução SQL.
  7. Na primeira página do assistente Nova Instrução SQL, mantenha os padrões para criar uma instrução SELECT utilizando o assistente e clique em Avançar.
  8. Na lista Tabelas Disponíveis, navegue até a tabela schemaname/schemaname.EMPLOYEE.
  9. Clique no botão > para mover a tabela para a lista Tabelas Selecionadas.
  10. Clique na guia Colunas.
  11. Expanda a árvore schemaname.EMPLOYEE e selecione EMPNO, FIRSTNME, LASTNAME e WORKDEPT.
  12. Clique no botão > para mover as colunas para a lista Colunas Selecionadas.
  13. Clique na guia Condições.
  14. Dê um clique duplo na primeira linha na coluna Coluna. Uma caixa drop-down é exibida.
  15. Clique na seta para baixo, selecione EMPLOYEE.WORKDEPT e pressione Enter para confirmar essa seleção.
  16. Na coluna Operador, aceite o operador padrão, =.
  17. Na coluna Valor, digite :dept e pressione Enter. Esta ação cria uma variável de host denominada dept que é utilizada como um parâmetro de entrada do usuário para o procedimento armazenado.
  18. Clique em Avançar para ver a instrução SQL criada. A instrução SQL se parece com o seguinte:
    SELECT EMPNO, FIRSTNME, LASTNAME, WORKDEPT   FROM SCHEMANAME.EMPLOYEE   WHERE WORKDEPT = :dept
  19. Clique em Concluir para fechar o assistente Nova Instrução SQL e clique em Avançar no assistente Novo Procedimento Armazenado.
  20. Na página Parâmetros, no campo Código de Manipulação de Erro SQL, selecione SQLSTATE e SQLCODE. Na tabela Parâmetros, você vê o parâmetro de entrada, dept, criado e os parâmetros de saída para SQLSTATE e SQLCODE. Nesta página, você pode, opcionalmente, criar outros parâmetros do usuário, mas para os propósitos deste tutorial você mantém os parâmetros como eles estão.
  21. Clique em Avançar.
  22. Na página Implementar Opções do assistente, selecione as caixas de opções Implementar e Ativar Depuração. Em etapas posteriores, você irá depurar o procedimento armazenado utilizando o depurador de procedimento armazenado SQL integrado que é incluído com o ambiente de trabalho, portanto, você estará implementando o procedimento e ativando a depuração aqui. Se você não selecionou a opção de depuração aqui, você pode implementar e ativar manualmente o procedimento armazenado para depuração posterior clicando com o botão direito do mouse no procedimento armazenado na visualização Data Project Explorer e selecionando Implementar no menu pop-up.
  23. Clique em Avançar. Na página Fragmentos de Código do assistente, você pode, opcionalmente, especificar arquivos que contêm fragmentos de código para inserir no corpo do procedimento armazenado. Neste caso, não especifique fragmentos de código.
  24. Clique em Avançar e revise suas seleções na página Resumo do assistente.
  25. Clique em Concluir para criar e implementar o procedimento armazenado.

O procedimento armazenado, SPEmployee, aparece na visualização Explorador de Projeto de Dados na pasta Procedimentos Armazenados no projeto em que ele foi criado. O procedimento armazenado também é aberto no editor, no qual é possível visualizar e editar o código fonte. Como você selecionou as opções Implementar e Ativar Depuração, o procedimento armazenado é automaticamente implementando e ativado para depuração. O ícone próximo ao procedimento armazenado na visualização Explorador de Projeto de Dados tem uma chave inglesa nele para indicar que o procedimento armazenado foi implementado. Os resultados da implementação podem ser vistos na visualização Saída de Dados.

Neste ponto, você pode, opcionalmente, utilizar o editor para fazer alterações no procedimento armazenado dependendo da necessidade do negócio.

< Anterior | Próximo >