Atividades do Banco de Dados de Saída de Tabela Única

Esta seção contém os procedimentos para configurar as atividades do banco de dados de saída de tabela única a seguir.

Estas atividades incluem:
  • Inserir Linhas - Esta atividade obtém dados da variável ou das variáveis que são mapeadas para os parâmetros de entrada da atividade e insere estes dados como linhas na tabela de banco de dados especificada.
  • Atualizar Linhas - Esta atividade obtém dados da variável ou da variáveis que são mapeadas para os parâmetros de entrada da atividade e atualiza as linhas da tabela de banco de dados especificada com estes novos dados.
  • Excluir Linhas - Esta atividade obtém dados da variável ou das variáveis que são mapeadas para os parâmetros de entrada da atividade e exclui linhas da tabela de banco de dados especificada com base nestes dados.
Para as atividades Atualizar Linhas e Excluir Linhas, o Integration Appliance integra a tabela de banco de dados para determinar quais colunas na tabela são colunas de chave primária. Quando as atividades Atualizar Linhas ou Excluir Linhas são iniciadas durante o tempo de execução, o Integration Appliance usa o valor da variável recebida que contém o número da chave primária para determinar quais linhas atualizar ou excluir.
Por exemplo, a coluna PK é definida no banco de dados como sendo uma coluna de chave primária para a tabela de banco de dados. A caixa de seleção Usar é selecionada para a coluna PK na tarefa Selecionar Tabela da Lista de Verificação para a atividade Excluir Linhas. Na área de janela Mapear Entradas da atividade Excluir Linhas, a variável chamada myIncomingPK é mapeada para o elemento PK da linha conforme mostrado em Figura 1:
Figura 1. myIncomingPK é Mapeado para o Elemento PK da Linha
Durante o tempo de execução, se o valor da variável myIncomingPK for igual a 3, a linha com o PK igual a 3 será excluída da tabela, conforme mostrado em Figura 2:
Figura 2. A Linha com a Chave Primária Igual a 3 é Excluída
Se nenhuma coluna de chave primária for especificada na tarefa Selecionar Tabela da Lista de Verificação, especifique pelo menos uma coluna para agir como a chave primária. Especifique a coluna ou colunas de chave primária que estão agindo usando a caixa de diálogo Configurar Chaves Primárias, disponível clicando em Chaves na tarefa Selecionar Tabela da Lista de Verificação para as atividades Excluir Linhas e Atualizar Linhas. Se nenhuma chave primária for especificada na tabela de banco de dados ou selecionada como chaves primárias atuantes na caixa de diálogo Configurar Chaves Primárias, todas as linhas da tabela de banco de dados serão afetadas pela operação de exclusão ou de atualização.

Também é possível usar a caixa de diálogo Configurar Chaves Primárias para especificar colunas adicionais para agirem como colunas de chave primária. Por exemplo, para a tabela na figura precedente, é possível definir que a coluna Nome deve agir como a coluna de chave primária, além da coluna primária de PK que foi definida no banco de dados como sendo uma coluna de chave primária.

Incluir uma Única Atividade do Banco de Dados de Saída de Tabela Única na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta Banco de Dados.
  3. Arraste a atividade do banco de dados de saída de tabela única desejada (Inserir Linhas, Excluir Linhas ou Atualizar Linhas) para a orquestração.
  4. Selecione a atividade.

Criar, Selecionar ou Editar um Terminal de Banco de Dados

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurar a Atividade".
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
  2. Crie ou edite um terminal HTTP, consulte Criando ou Editando um Terminal HTTP.

Selecione as colunas na tabela de banco de dados de origem em que, durante o tempo de execução, o Integration Appliance pesquisa mudanças

  1. Clique em Selecionar Tabela na Lista de Verificação. A área de janela Selecionar Tabela é exibida.
  2. Clique em Procurar... para selecionar a tabela de banco de dados que deve ser a origem para mensagens de entrada. A caixa de diálogo Procurar Tabelas de Banco de Dados é exibida.
  3. Selecione uma tabela na lista e clique em OK. As informações da coluna para a tabela selecionada são exibidas na área de janela Selecionar Tabela.
  4. Se a codificação de caracteres para esta tabela for diferente da codificação para o banco de dados, insira outra codificação usando uma das opções a seguir:
    • Na lista Codificação, selecione um dos tipos de codificação padrão.
    • Insira seu tipo de codificação diretamente clicando no campo Codificação e digitando seu tipo de codificação.
    Isto configura a codificação para todas as colunas da tabela de buffers resultante.
    Nota: Alguns caracteres de byte duplo não são convertidos com o uso da codificação SHIFT-JIS. Para obter informações adicionais, consulte Usando a Codificação Shift-JIS.
  5. Por padrão, todas as colunas na tabela de origem são selecionadas. Limpe a caixa de seleção Usar para remover uma coluna da tabela de buffers resultante. Clique em Usar Todos para selecionar novamente todas as colunas.
  6. Clique no título da coluna para classificar as linhas pelo valor da coluna. Por exemplo, para classificar as linhas por seus nomes de coluna, clique no título Nome da Coluna da coluna. Uma seta é exibida à direita do nome do cabeçalho da coluna. Uma seta para cima indica que a coluna é classificada em ordem alfabética iniciando com a e continuando até z. Uma seta para baixo indica que a coluna é classificada em ordem alfabética reversa iniciando com z e continuando até a. Clique na seta para reverter a ordem alfabética.
  7. Apenas para a atividade Obter Linhas Atualizadas - se desejar que a tabela de buffers resultante contenha os novos valores e os valores originais das colunas atualizadas, siga estas etapas:
    1. Clique em Valores Antigos. A caixa de diálogo Colunas de Valores Antigos para Atualizações é exibida.
    2. Selecione a caixa de seleção Armazenar para as colunas de banco de dados em que deseja salvar os valores originais.
    3. É possível alterar os nomes padrão designados para colunas para armazenar os valores originais. Dê um clique duplo na célula Nome da Coluna para Armazenar Valor Antigo apropriada.
    4. Clique em OK.As colunas selecionadas são exibidas em Da Atividade da área de janela Mapear Saídas prefixadas com a sequência: old_. É possível mapear os valores novo e original a partir da área de janela Mapear Saídas.
    Nota: Para obter informações adicionais, consulte Definindo Colunas para Valores Antigos em Atualizações.
  8. Se necessário, altere as configurações dos valores Tipo de Dado, Codificação ou Anulável. Clique no campo para fazer uma nova seleção.
    • Tipo de Dado - Padronizado com o tipo de dado para a coluna na tabela de banco de dados de origem. Se o tipo de dado necessário para a coluna na tabela de buffers for diferente do tipo de dado da tabela de origem, selecione um tipo de dado diferente clicando na célula Tipo de Dado e selecionando outro Tipo de Dado na lista. Você deve selecionar um tipo de dado apropriado para esses tipos de dados que são marcados como NÃO SUPORTADOS.
      Nota: Para o tipo de dado XMLTYPE em um banco de dados Oracle e os tipos de dados MONEY em um banco de dados do SQL Server, o Studio não associa automaticamente o tipo de dado correto, portanto, você deve selecionar manualmente o tipo de dado apropriado.
      Atenção: Você deve selecionar um tipo de dado compatível com o tipo de dado de origem para evitar dados inválidos durante o tempo de execução. Por exemplo, não selecione o tipo de dado SMALLINT para a tabela de buffers se o tipo de dado de origem for INTEGER porque, durante o tempo de execução, um número grande armazenado em uma coluna INTEGER não será convertido corretamente no tipo de dado SMALLINT.
    • Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado da tabela de banco de dados e não é configurável.
    • Encoding - É padronizado com a codificação padrão atual que foi configurada no nível do banco de dados ou no nível da tabela. Se a codificação necessária para a coluna for diferente da codificação padrão atual, selecione outra codificação clicando na célula Codificação e selecionando outra Codificação na lista.
    • Anulável - Padronizado com a configuração anulável para a coluna na tabela de banco de dados de origem. A caixa de seleção Usar deve ser selecionada para as colunas em que nullable=false. Uma coluna marcada como nullable=false não pode conter um nulo durante o tempo de execução.
  9. Clique em Reconfigurar para reconfigurar todas as propriedades da coluna com seus padrões. Isto também reconfigura a caixa de seleção Usar para todas as colunas.
  10. Clique em Atualizar para atualizar a lista de colunas em referência ao estado mais recente do banco de dados de origem. As mudanças recentes na origem são atualizadas nesta área de janela.
  11. Configure o Especificando Regras de Entrega para Atividades do Banco de Dados.
    Nota: Se você selecionar a opção Exatamente uma vez na tarefa Regras de Entrega, deverá criar tabelas de controle que serão usadas pelo Integration Appliance durante o tempo de execução. Crie as tabelas de controle após publicar a orquestração do Studio para o Integration Appliance. Crie as tabelas de controle usando o Web Management Console (WMC) antes de implementar o projeto.
    Nota: Se selecionar a opção Exatamente Uma Vez, você deverá ativar a persistência. Para obter informações adicionais, consulte Ativando a Persistência.
  12. Configure as opções de nova tentativa. Para obter informações adicionais, consulte Opções de Nova Tentativa para Atividades do Banco de Dados de Entrada.

Especifique a Tabela do Banco de Dados de Destino para a Atividade

  1. Clique em Selecionar Tabela na Lista de Verificação. A área de janela Selecionar Tabela é exibida.
  2. Clique em Procurar... para selecionar a tabela do banco de dados de destino. A caixa de diálogo Procurar Tabelas de Banco de Dados é exibida.
  3. Selecione uma tabela na lista e clique em OK. As informações da coluna para a tabela selecionada são exibidas na área de janela Selecionar Tabela.
  4. Se a codificação de caracteres para esta tabela for diferente da codificação para o banco de dados, insira outra codificação usando uma das opções a seguir:
    • Na lista Codificação, selecione um dos tipos de codificação padrão.
    • Insira seu tipo de codificação diretamente clicando no campo Codificação e digitando seu tipo de codificação.
    Isto configura a codificação para todas as colunas da tabela de buffers resultante.
    Nota: Alguns caracteres de byte duplo não são convertidos com o uso da codificação SHIFT-JIS. Para obter informações adicionais, consulte Usando a Codificação Shift-JIS.
  5. Por padrão, todas as colunas na tabela de origem são selecionadas. Limpe a caixa de seleção Usar para remover uma coluna da tabela de buffers resultante. Se uma coluna não for selecionada, ela não será exibida na área de janela Mapear Entradas e não será atualizada no tempo de execução. Clique em Usar Todos para selecionar novamente todas as colunas.
  6. Clique no título da coluna para classificar as linhas pelo valor da coluna. Por exemplo, para classificar as linhas por seus nomes de coluna, clique no título Nome da Coluna da coluna. Uma seta é exibida à direita do nome do cabeçalho da coluna. Uma seta para cima indica que a coluna é classificada em ordem alfabética iniciando com a e continuando até z. Uma seta para baixo indica que a coluna é classificada em ordem alfabética reversa iniciando com z e continuando até a. Clique na seta para reverter a ordem alfabética.
  7. Se necessário, altere as configurações dos valores Tipo de Dado, Codificação ou Anulável. Clique no campo para fazer uma nova seleção.
    • Tipo de Dado - Padronizado com o tipo de dado para a coluna na tabela de banco de dados de origem. Se o tipo de dado desejado para a coluna na tabela de buffers for diferente do tipo de dado da tabela de origem, selecione um tipo de dado diferente clicando na célula Tipo de Dado e selecionando outro Tipo de Dado na lista. Você deve selecionar um tipo de dado apropriado para esses tipos de dados que são marcados como NÃO SUPORTADOS.
      Nota: Para o tipo de dado XMLTYPE em um banco de dados Oracle e os tipos de dados MONEY em um banco de dados do SQL Server, o Studio não associa automaticamente o tipo de dado correto, portanto, você deve selecionar manualmente o tipo de dado apropriado.
      Atenção: Você deve selecionar um tipo de dado compatível com o tipo de dado de origem para evitar dados inválidos durante o tempo de execução. Por exemplo, não selecione o tipo de dado SMALLINT para a tabela de buffers se o tipo de dado de origem for INTEGER porque, durante o tempo de execução, um número grande armazenado em uma coluna INTEGER não é convertido corretamente no tipo de dado SMALLINT.
    • Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado da tabela de banco de dados e não é configurável.
    • Encoding - É padronizado com a codificação padrão atual que foi configurada no nível do banco de dados ou no nível da tabela. Se a codificação desejada para a coluna for diferente da codificação padrão atual, selecione outra codificação clicando na célula Codificação e selecionando outra Codificação na lista.
    • Anulável - Padronizado com a configuração anulável para a coluna na tabela de banco de dados de origem. A caixa de seleção Usar deve ser selecionada para as colunas em que nullable=false. Uma coluna marcada como nullable=false não pode conter um nulo durante o tempo de execução.
  8. Clique em Reconfigurar para reconfigurar todas as propriedades da coluna com seus padrões. Isto também reconfigura a caixa de seleção Usar para todas as colunas.
  9. Clique em Atualizar para atualizar a lista de colunas em referência ao estado mais recente do banco de dados de origem. As mudanças recentes na origem são atualizadas nesta área de janela.
  10. Apenas para a atividade Atualizar Linhas - Selecione a caixa de seleção Inserir linha se a linha ainda não existir se, durante o tempo de execução, você desejar que a atividade Atualizar Linhas tente atualizar primeiro a linha especificada mas, se a linha não existir, insira a linha na tabela de banco de dados.
  11. Apenas para a atividade Atualizar Linhas - se você desejar salvar ambos os valores, novo e original, no banco de dados, siga estas etapas:
    1. Clique em Valores Antigos. A caixa de diálogo Colunas de Valor Antigo para Atualizações é exibida.
    2. Selecione a caixa de seleção Armazenar para as colunas de banco de dados em que deseja salvar os valores originais.
    3. É possível alterar os nomes padrão designados às colunas que armazenam os valores originais durante o tempo de execução. Dê um clique duplo na célula Nome da Coluna para Armazenar Valor Antigo apropriada.
    4. Clique em OK.As colunas selecionadas são exibidas em Para Atividade da área de janela Mapear Saídas, prefixadas com a sequência: old_. É possível mapear para ambos os valores, novo e original, a partir da área de janela Mapear Saídas.
    Nota: Para obter informações adicionais, consulte Definindo Colunas para Valores Antigos em Atualizações.
  12. Apenas para as atividades Atualizar Linhas ou Excluir Linhas - Para especificar as colunas de chave primária atuantes, além de quaisquer colunas de chave primária já definidas pelo banco de dados, siga estas etapas:  
    1. Clique em Chaves. A caixa de diálogo Configurar Chaves Primárias é exibida.
    2. Para especificar uma coluna como uma coluna de chave primária atuante, clique na coluna, em seguida, clique em >>.
    3. Clique em OK.
    Nota: Se nenhuma coluna de chave primária (conforme definido pelo banco de dados) foi especificada na tabela Selecionar Tabela da Lista de Verificação, você deverá especificar pelo menos uma coluna como uma coluna de chave primária atuante.
    Repita esta etapa para especificar mais colunas de chave primária atuantes.
  13. Configure o Especificando Regras de Entrega para Atividades do Banco de Dados.
    Nota: Se você selecionar a opção Exatamente uma vez na tarefa Regras de Entrega, deverá criar tabelas de controle que serão usadas pelo Integration Appliance durante o tempo de execução. Crie as tabelas de controle após publicar a orquestração do Studio para o Integration Appliance. Crie as tabelas de controle usando o Web Management Console (WMC) antes de implementar o projeto.
    Nota: Se selecionar a opção Exatamente Uma Vez, você deverá ativar a persistência. Para obter informações adicionais, consulte Ativando a Persistência.
  14. Configure as opções de nova tentativa. Para obter informações adicionais, consulte Opções de Nova Tentativa para Atividades do Banco de Dados de Saída.

Mapear a Entrada da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação.
    Os parâmetros de entrada para a atividade são exibidos no elemento row na área de janela Para Atividade. Os parâmetros de entrada exibidos na área de janela Da Atividade correspondem às colunas selecionadas na tarefa Selecionar Tabela. Se a caixa de seleção Colocar Diversas Linhas em Lote Por Mensagem foi selecionada nas Regras de Entrega, o símbolo de diversas ocorrências será exibido próximo ao elemento row.
    Nota: Somente para a atividade Obter linhas atualizadas, se as colunas foram selecionadas na caixa de diálogo Colunas de valores antigos para atualizações (na tarefa Selecionar tabela), esses parâmetros de saída adicionais (por padrão prefixados com a sequência: old_) também serão exibidos no elemento de linhas.
  2. Mapeie todos os parâmetros de entrada. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Você deve mapear todos os parâmetros de entrada da atividade.

Mapear a Saída da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação.
    A caixa de seleção GetRowsCount determina o que é exibido na área de janela Mapear Saídas:
    • Se a caixa de seleção Obter Contagens de Linha for desmarcada nas Regras de Entrega, a área de janela Mapear Saídas ficará em branco.
    • Se a caixa de seleção Obter Contagens de Linha for selecionada nas Regras de Entrega, a área de janela Mapear Saídas exibirá o elemento rowCount. Se a caixa de seleção Colocar Diversas Linhas em Lote Por Mensagem for selecionada nas Regras de Entrega, o símbolo de diversas ocorrências será exibido próximo ao elemento rowCount.
  2. Se o parâmetro de saída RowCount for exibido, mapeie o parâmetro de saída RowCount, se desejado. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Não é necessário mapear os parâmetros de saída da atividade.