Utilize o nó DataInsert para interagir com um banco de dados na origem de dados ODBC especificada.
Este tópico contém as seguintes seções:
O nó DataInsert é um formato especializado do nó Banco de Dados, e a interação está restrita à inserção de uma ou mais linhas em uma tabela dentro do banco de dados. Você especifica o que é inserido definindo instruções de mapeamento que utilizam os dados da mensagem de entrada para definir a ação necessário.
Você pode definir uma propriedade para controlar se a atualização ao banco de dados é consolidada imediatamente ou adiada até que o fluxo de mensagens seja concluído, momento em que a atualização é consolidada ou revertida de acordo com o status geral de conclusão do fluxo de mensagens.
O nó DataInsert está contido no repositório Banco de Dados da paleta e é representado no ambiente de trabalho pelo seguinte ícone:
Considere uma situação na qual sua empresa desenvolveu um novo produto. Os detalhes sobre o produto foram enviados do departamento de engenharia e você precisa extrair detalhes da mensagem e incluí-los como uma nova linha no banco de dados de estoque.
Quando tiver colocado uma instância do nó DataInsert em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, clique com o botão direito do mouse no nó e clique em Propriedades. (Se você der um clique duplo no nó DataInsert, abrirá a caixa de diálogo Novo Mapa de Mensagem.) Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
Os terminais do nó DataInsert são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Failure | O terminal de saída para qual a mensagem de entrada será propagada caso seja detectada uma falha durante o cálculo. Se você tiver selecionado Tratar Avisos como Erros, o nó propagará a mensagem para esse terminal mesmo se o processamento for concluído com êxito. |
Out | O terminal de saída que exibe a mensagem após a execução da instrução do banco de dados. |
As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).
As propriedades Descrição do nó DataInsert são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | DataInsert | O nome do nó. |
Descrição Breve | Não | Não | Uma breve descrição do nó. | |
Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |
As propriedades Básicas do nó DataInsert são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Origem de dados | Não | Sim | O nome da origem de dados ODBC do banco de dados que contém
as tabelas às quais você se refere nos mapeamentos que estão associados a este
nó (identificado pela propriedade Instrução).
Este nome identifica o banco de dados apropriado no sistema no qual este
fluxo de mensagens deve ser executado. O intermediário conecta-se às informações de ID de usuário e senha especificadas no comandomqsicreatebroker, mqsichangebroker oumqsisetdbparms.
|
|
Instrução | Sim | Não | DataInsert | O nome da rotina de mapeamento que contém as
instruções que são executadas no banco de dados ou à árvore de
mensagens.
A rotina é
exclusiva para esse tipo de nó. Por padrão, o nome designado à
rotina de mapeamento é idêntico ao nome do arquivo de mapeamentos no qual a rotina é
definida. O nome padrão para o arquivo é o nome do fluxo de mensagens
concatenado com o nome do nó quando você o inclui no fluxo de mensagens
(por exemplo, MFlow1_DataInsert.msgmap para o primeiro nó DataInsert no fluxo de mensagens MFlow1).
Você não pode especificar um valor que inclui espaços. Se você clicar em Procurar ao lado desse campo de entrada, será exibida uma caixa de diálogo que lista todas as rotinas de mapeamento disponíveis que podem ser acessadas por esse nó. Selecione a rotina desejada e clique em OK; o nome da rotina é definido em Instrução (Statement). Para trabalhar com a rotina de mapeamento associada a esse nó, dê um clique duplo no nó ou clique com o botão direito do mouse no nó e selecione Abrir Mapeamentos (Open Mappings). Se a rotina de mapeamento não existir, ela será criada com o nome padrão no arquivo padrão. Se o arquivo já existir, você também pode abrir o arquivo flow_name_node_name.msgmap na visualização Desenvolvimento do Intermediário. Uma rotina de mapeamento é específica do tipo de nó ao qual ela está associada; não é possível utilizar uma rotina de mapeamento que tenha sido desenvolvida para um nó DataInsert com qualquer outro nó que utiliza mapeamentos (por exemplo, um nó DataDelete). Se você criar uma rotina de mapeamento, não será possível chamá-la a partir de outra rotina de mapeamento, embora seja possível chamá-la a partir de uma rotina ESQL. Para obter informações adicionais sobre o trabalho com os arquivos de mapeamento, e a definição de seu conteúdo, consulte Desenvolvendo Mapeamentos de Mensagens. |
Transação | Sim | Não | Automático | O modo de transação para o nó. Os valores são:
|
Tratar Avisos como Erros | Sim | Não | Não Selecionada | Para que as mensagens de aviso do banco de dados sejam tratadas como erros e para que o nó propague a mensagem de saída para o terminal de falha, selecione Tratar avisos como erros. A caixa de opção
é limpa por padrão. Quando você selecionar a caixa de opções, o nó tratará todos os códigos de retorno positivos do banco de dados como erros e gerará exceções da mesma forma que faria para os erros negativos ou mais graves. Se você não selecionar a caixa de opção, o nó trata avisos como códigos de retorno típicos e não gera nenhuma exceção. O aviso mais significativo criado é não localizado, que pode ser manipulado como um código de retorno típico na maioria das circunstâncias. |
Exceção emitida em erro do banco de dados | Sim | Não | Selecionada | Para fazer com que o intermediário gere uma exceção quando um erro do banco de dados
for detectado, selecione Emitir exceção em erro do
banco de dados (Throw exception on database error).
A caixa de opção é selecionada por padrão. Se você desmarcar a caixa de opções, deverá tratar o erro no fluxo de mensagens para assegurar a integridade do intermediário e do banco de dados; o erro será ignorado se você não tratá-lo pelo seu próprio processamento, porque você optou por não chamar o tratamento de erros padrão pelo intermediário. Por exemplo, você pode conectar o terminal de falha a uma sub-rotina de processamento de erro. |