Use o editor de Mapeamento de Dados Gráficos para inserir dados em uma tabela de banco de dados.
Antes de iniciar:
É preciso concluir a seguinte tarefa:
Crie um mapa de dados gráfico usando o editor de Mapeamento de Dados Gráficos. Para obter informações,
consulte Criando mapa de dados gráficoss.
Para inserir uma linha ou diversas linhas em uma tabela de banco de dados
usando o editor de Mapeamento de Dados Gráficos, conclua as seguintes etapas:
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 do mouse 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.
No campo Banco de Dados, selecione o banco de
dados que você 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 informações adicionais, 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 de banco de dados diferente no tempo de execução, é possível substituir esse valor configurando a propriedade databaseName do serviço configurável JDBCProvider que se conecta ao seu banco de dados; consulte Configurando um Provedor JDBC para Conexões Tipo 4.
No campo Esquema, selecione o esquema do banco de dados que você deseja usar para construir a transformação. Para usar um esquema de banco de dados diferente no tempo de execução, é possível substituir esse valor configurando a propriedade databaseSchemaNames do serviço configurável JDBCProvider que se conecta ao seu banco de dados; consulte Configurando um Provedor JDBC para Conexões Tipo 4.
No campo Tabela, selecione a tabela
que deseja modificar.
Opcional: Selecione Tratar 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: 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.
Clique
em OK. Uma transformação Inserir e uma transformação
Retornar são criadas como um grupo de transformações e são
exibidas em seu mapa de dados gráficos. A transformação Retornar é um tipo
de transformação opcional. Se você não precisar usar a transformação Retornar, poderá excluí-la do seu mapa de dados gráficos.
Opcional: Para substituir uma transformação Retornar excluída do seu mapa de dados
gráficos, clique com o botão direito do mouse em sua transformação Inserir e selecione Banco de Dados > Utilizar Retornar.
No editor de
Mapeamento de Dados Gráficos, conecte objetos de entrada à conversão Inserir
para definir o conteúdo da 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 à transformação Inserir para inserir várias linhas na tabela de banco de dados selecionada. Para conectar vários elementos de repetição, selecione seus elementos de repetição e, em seguida, clique com o botão direito do mouse na transformação Inserir e selecione Criar Conexão.
Se você conectar um único elemento de repetição, a transformação Inserir será aninhada dentro de uma transformação Para Cada. Se você conectar vários elementos de repetição, a transformação Inserir será aninhada dentro de uma transformação Junção. Seja qual for o caso, a transformação aninhada é aberta para que você possa continuar a editar sua transformação Inserir.
Clique na conversão Inserir para criar conexões
às colunas na linha inserida e para definir com mais detalhes
a conversão.
Opcional: Conecte a conversão Retornar para implementar um mapeamento
aninhado que será chamado se a operação Inserir tiver sido concluída com
êxito.
Opcional: Clique na conversão Retornar para definir melhor a conversão. É criado um mapa aninhado, no
qual é possível selecionar as conversões específicas que são necessárias para
os elementos de entrada e saída.
A seguir:
Se você desejar que exceções sejam retornadas do servidor de banco de dados
quando a operação SQL for executada para que seja manipulada pelo mapa, em vez de
as exceções pararem o mapa e serem relatadas, poderá incluir uma transformação de Falha no grupo de transformações; consulte Manipulando Exceções de Banco de Dados em um Mapa de Dados Gráfico.