Chamando um procedimento armazenado a partir de um Mapa

Use o editor de Mapeamento de Dados Gráficos para chamar um procedimento armazenado usando o Rotina de Banco de Dados .

Antes de começar:
É preciso concluir a seguinte tarefa:

É possível usar o Rotina de Banco de Dados para chamar um procedimento armazenado a partir de um banco de dados.

Nota: Somente IBM® DB2 procedimentos armazenados são suportados no IBM Integration Bus v9.0.

A Rotina de Banco de Dados conversão age como um mapeamento aninhado, no qual você pode ligar entradas para criar mapeamentos para configurar os valores de parâmetros de entrada para o procedimento armazenado histórico. Os parâmetros de entrada da rotina são exibidos como saídas de mapeamento aninhado Rotina de Banco de Dados. Não é possível conectar as saídas da transformação do Rotina de Banco de Dados.

Use a conversão Retornar dentro do grupo de conversão do Rotina de Banco de Dados para mapear quaisquer parâmetros de saída, valores de retorno, ou ResultSets produzidos pelo chamando o Rotina de Banco de Dados. É possível ligar quaisquer entradas adicionais que você deseja mapear quando a chamada Rotina de Banco de Dados for concluída com êxito. Os parâmetros de saída, qualquer valor de retorno, e quaisquer conjuntos de resultados retornados é definido para o Rotina de Banco de Dados são fornecidos como entradas no mapeamento aninhado de retorno. É possível ligar o Retornar a um único ou vários irmão de elementos para ativar os dados retornados para ser mapeado para a saída do mapa.

Usando o editor de Mapeamento de Dados Gráficos, conclua as seguintes etapas:

  1. Com um arquivo de mapa de dados (.map) abra no editor Graphical Data Mapping, clique com o botão direito a tela, e selecione Banco de Dados > Chamada de Rotina de Banco de Dados .
    • Como alternativa, selecione um elemento de esquema (ou elementos) como um valor do parâmetro de entrada. Como alternativa, selecione um elemento de esquema (ou elementos) como um valor de saída.
    • Você também pode usar arrastar e soltar para criar o Rotina de Banco de Dados . Conecte o objeto de entrada para o objeto de saída, e uma transformação será criado automaticamente. Selecione a transformação, e escolha Rotina de Banco de Dados na lista Transformações .
    • Você também pode clicar no ícone Chamar um procedimento armazenado em um banco de dados.Chame um procedimento armazenado em um ícone do banco de dados
    O assistente Rotina de Banco de Dados é exibido.
  2. No campo Banco de Dados , selecione o banco de dados que você deseja chamar a rotina do. Para incluir um arquivo de definição de banco de dados ou para descobrir um novo banco de dados, que se conectam ao IBM Integration Toolkit usando JDBC a um servidor de banco de dados, clique em Incluir .... Para obter informações adicionais, consulte Criando uma Definição de Banco de Dados Usando o Assistente Novo Arquivo de Definição de Banco de Dados. Você deve selecionar a opção Rotinas durante o processo de descoberta. Para usar um nome de banco de dados diferente no tempo de execução que o nome utilizado no Toolkit, é possível substituir esse valor configurando a propriedade databaseName do serviço configurável JDBCProvider que define como se conectar ao seu banco de dados; consulte Configurando um Provedor JDBC para Conexões Tipo 4.
  3. No campo Esquema , selecione o esquema do banco de dados que define o procedimento armazenado que você deseja chamar a partir do mapa. Para chamar o procedimento armazenado de um esquema do banco de dados diferente no tempo de execução, você pode substituir este valor configurando a propriedade databaseSchemaNames do serviço configurável JDBCProvider que define como conectar seu banco de dados; consulte Configurando um Provedor JDBC para Conexões Tipo 4.
  4. No campo Rotina , selecione o procedimento armazenado que você deseja chamar para conversão no mapa Rotina de Banco de Dados .
    1. Opcional: Se a rotina selecionada pode retornar um valor, uma caixa de opção Retornar Valor é exibida. Se desejar fazer o valor de retorno disponíveis para mapeamento na transformação Retornar, marque esta caixa.
    Nota: A selecionada Rotina então preenche os seguintes campos bloqueados:
    • Tipo: indica se o tipo do selecionado Rotina é um procedimento armazenado .
    • Parâmetros: os detalhes dos nomes de parâmetros, modo e tipo para a selecionada Rotina.
    • Máx ResultSets: se o arquivo de definição de banco de dados para o Rotina fornece essas informações, estabelece os conjuntos de resultados máximos. Caso contrário, ficará em branco.

    Estes campos podem ser exibidos clicando em Exibir Detalhes de Parâmetro de Rotina...

  5. Opcional: Selecione Tratar aviso como erro. Se esta opção for selecionada e chamando o Rotina de Banco de Dados no banco de dados de tempo de execução configurado retorna um aviso de SQL, ele é tratado como se o banco de dados está elevando uma exceção. Se a conversão Failure estiver presente, então ela entra em seu mapeamento aninhado. Caso contrário, a execução do mapa para, e uma exceção é levantada do nó Mapeamento que está executando o mapa.
    Importante: Os avisos de banco de dados são específicos do fornecedor. Para obter informações adicionais sobre avisos de banco de dados, consulte a documentação de seu produto de banco de dados.
  6. Opcional: Se a selecionada Rotina pode retornar conjuntos de Resultados, e você deseja mapear valores a partir deles, você deve definir sua ordem de conteúdo e coluna.
    1. Se seu arquivo de definição de banco de dados definidos o número de conjuntos de resultados, em seguida, a Lista de Conjuntos de Resultados será pré-preenchida com um Resultadose exibe o número máximo que podem ser retornados. Use os botões Incluir e Excluir para preencher a Lista de Conjuntos de Resultados, até qualquer número máximo definido no arquivo de definição de banco de dados. É necessário solicitar os conjuntos de resultados conforme eles são definidos no código de Rotina de Banco de Dados . Se você desejar apenas para mapear dados a partir de, por exemplo, o conjunto de resultados segundo, você ainda deve incluir o primeiro conjunto de resultados na tabela porque eles são acessados por sua ordem posicional.
    2. Selecione cada conjunto de resultados e use as caixas de opções nas Colunas da Tabela Disponíveis para incluir as definições de coluna para o conjunto de resultados para corresponder ao que o Rotina de Banco de Dados retorna. Você só precisa definir as colunas do conjunto de resultados que você deseja que esteja disponível para o mapeamento.
  7. Clique em OK. O Rotina de Banco de Dados e seu Retorno agrupado de transformação são exibidas em seu mapa de dados gráficos. Se você fez qualquer seleção no mapeamento de entrada / saída, todas as entradas selecionadas são ligadas para o Rotina de Banco de Dadose saídas são ligados para a transformação Retornar. Se você não fez seleções, em seguida, a nova transformação aparece no mapa desconectado.
  8. Forneça quaisquer valores requeridos paraIN e INOUT modo de parâmetros para o Rotina de Banco de Dados. Os parâmetros de entrada para o selecionado procedimento armazenado são exibidos como saídas na transformação aninhada. Rotina de Banco de Dados
    1. Conecte os elementos de entrada necessários para o Rotina de Banco de Dadose com o mapa aninhado fornecem transformações para configurar um valor para cada parâmetro. O Rotina de Banco de Dados é inserido apenas uma vez, fazendo uma chamada para o sistema de banco de dados. Você deve configurar cardinalidade para quaisquer elementos de repetição que estão conectados no Rotina de Banco de Dados , ou usar uma função de transformação para fornecer um único valor para o parâmetro.
      Nota: Se qualquer parâmetro não for fornecido um valor, o servidor de banco de dados pode retornar uma exceção se ele não puder fornecer um valor padrão. Se o valor de saída resultante das transformações configurar os parâmetros não é o tipo correto para o Rotina de Banco de Dados, ou o conteúdo é inválido, por exemplo, exceder um comprimento máximo, uma exceção de banco de dados podem ocorrer.
  9. Forneça qualquer mapeamento obrigatório para os elementos de saída de dados que são retornados do Rotina de Banco de Dados. Estes dados podem incluir modos de parâmetros OUT e INOUT , opcional de Rotina valores de retorno, e um ou mais conjuntos de resultados. As saídas Rotina são exibidas como entradas na transformação Retornar aninhadas.
    1. Opcional: Conecte quaisquer elementos de entrada adicionais que você pode precisar mesclado com os Rotina de Banco de Dados dados para a transformação Retornar. Conecte a transformação Retornar para um ou mais elementos de saída do mapa. Forneça a conversão com o mapa de retorno aninhado para configurar saídas dos valores de saída fornecidos Rotina de Banco de Dados .
Avançar:
Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:10:34


Tópico de TarefaTópico de Tarefa | IBM Integration Bus Versão 9.0.0.0 | cm28838_