Inserindo Dados em uma Tabela

Use o editor de Mapeamento de Dados Gráficos para inserir dados em uma tabela de banco de dados.

1. Com um arquivo de mapa de dados gráficos (.map) aberto no editor de Mapeamento de Dados Gráficos, clique com o botão direito na tela e selecione Banco de Dados > Inserir na Tabela. Como alternativa, selecione um elemento de esquema como objeto de entrada e, em seguida, clique no ícone Inserir uma linha em uma tabela de banco de dados.
   
   O assistente Inserir é exibido.
2. No campo Banco de Dados , selecione o banco de dados que deseja modificar. Para incluir um arquivo de definição de banco de dados ou para descobrir um novo banco de dados conectando-se a um servidor de banco de dados, clique em Incluir Banco de Dados.... Para obter mais informações, consulte Criando uma definição de banco de dados (arquivo .dbm) usando o assistente Novo Arquivo de definição de banco de dados.
   Para usar um nome do banco de dados diferente no tempo de execução, é possível substituir esse valor configurando a propriedade Nome do banco de dados da política de Provedores JDBC que se conecta ao banco de dados; consulte a política de Provedores JDBC (JDBCProviders).
3. No campo Esquema , selecione o esquema do banco de dados que você deseja usar para construir a transformação.
   Para usar um esquema do banco de dados diferente no tempo de execução, é possível substituir esse valor configurando a propriedade Nome do esquema do banco de dados da política de Provedores JDBC que se conecta ao seu banco de dados; consulte JDBC (JDBCProviders)
4. No campo Tabela , selecione a tabela que você deseja modificar.
5. Opcional: Selecione Treat aviso como erro.
   Se essa opção for selecionada, a primeira operação de SQL que resultar em um aviso do banco de dados selecionado levantará uma exceção.

   Importante: 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. Clique em OK.
   Uma conversão Inserir e uma conversão Retornar são criadas como um grupo de conversões e são exibidas em seu mapa de dados gráficos. A conversão Retornar é um tipo de conversão opcional. Se você não precisar usar a conversão Retornar, poderá excluí-la do seu mapa de dados gráficos.
7. Opcional: Para substituir uma conversão Retornar que você excluiu de seu mapa de dados gráficos, clique com o botão direito do mouse na conversão Inserir e selecione Banco de dados > Utilizar retorno.
8. No editor de Mapeamento de Dados Gráficos, conecte objetos de entrada à transformação Inserir para definir o conteúdo de sua linha inserida.
   • Conecte um elemento de não repetição à conversão Inserir para inserir uma linha única na tabela de banco de dados selecionada.
   • Conecte um ou mais elementos de repetição à conversão Inserir para inserir várias linhas na tabela de banco de dados selecionada. Para se conectar a diversos elementos repetidos, selecione seus elementos repetidos e, em seguida, clique com o botão direito na conversão Inserir e selecione Incluir Conexão.
   Se você conectar um único elemento de repetição, a conversão Inserir será aninhada dentro de uma conversão Para Cada. Se você conectar vários elementos de repetição, a conversão Inserir será aninhada dentro de uma conversão Junção. Seja qual for o caso, a conversão aninhada é aberta para que você possa continuar a editar sua conversão Inserir.
9. Clique na transformação Inserir para criar conexões com as colunas em sua linha inserida, e para definir ainda mais a transformação.
10. Opcional: Se você precisar fornecer manipulação para o elemento de origem conectado sendo Ausente, Vazio ou Nil, você pode configurar uma Política de Banco de Dados. Consulte Comportamento ao modificar valores de coluna de banco de dados de elementos de origem opcionais.
11. Opcional: Conecte-se a transformação Return para implementar um mapeamento aninhado que é chamado se a operação Inserir foi concluída com sucesso.
12. Opcional: Clique na transformação Retorno para definir ainda mais a transformação.
    É criado um mapa aninhado, no qual é possível selecionar as transformações específicas que são necessárias para os elementos de entrada e saída.