WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

DataDelete

Utilize o nó DataDelete para interagir com um banco de dados na origem de dados ODBC especificada.

Restrição: As funções fornecidas por esse nó foram substituídas por um Nó Mapeamento revisado. Se você importar um fluxo de mensagens que contenha o nó DataDelete, poderá continuar visualizando-o e implementando-o, mas não poderá modificá-lo.

Este tópico contém as seguintes seções:

Propósito

O nó DataDelete é um formato especializado do nó Banco de Dados, e a interação é restrita à exclusão de uma ou mais linhas de uma tabela no banco de dados. Você especifica o que é excluído definindo as instruções de mapeamento que utilizam os dados da mensagem de entrada para identificar a ação necessária.

Você pode definir uma propriedade para controlar se a atualização do banco de dados será confirmada imediatamente ou adiada até que o fluxo de mensagens seja concluído, no momento em que a atualização for confirmada ou revertida, de acordo com o status geral de conclusão do fluxo de mensagens.

Utilizando este nó em um fluxo de mensagens

Considere uma situação na qual você está executando uma promoção limitada. As mercadorias estão disponíveis apenas durante o período da promoção, e cada cliente pode adquirir apenas um item. Quando o estoque da mercadoria acabar, você deve remover os respectivos detalhes do banco de dados de estoque. Quando aparecer uma mensagem contendo um pedido do último item, o nó DataDelete será acionado para remover todos os detalhes sobre esse item do banco de dados.

Terminais e Propriedades

Quando tiver colocado uma instância do nó DataDelete 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. (Se você der um clique duplo no nó DataDelete, abrirá a caixa de diálogo Novo Mapa de Mensagem.) Todas as propriedades obrigatórias para as quais é necessário inserir um valor (as propriedades que não têm um valor-padrão definido) são marcadas com um asterisco.

Os terminais do nó DataDelete são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saía 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.
Saída 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ó DataDelete são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não DataDelete O nome do nó.
Short description 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ó DataDelete são descritas na tabela a seguir.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
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 conforme ele é conhecido no sistema no qual este fluxo de mensagens deve ser executado. O broker conecta-se a este banco de dados com informações de ID do usuário e senha que você especificou no comando do mqsisetdbparms.

dataSource
Instrução Sim Não DataDelete 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_DataDelete.msgmap para o primeiro nó DataDelete no fluxo de mensagens MFlow1). Você não pode especificar um valor que inclui espaços.

Se você clicar em Navegar junto a este campo de entrada, será exibida uma caixa de diálogo que lista todas as rotinas de mapeamento disponíveis que podem ser acessadas por este 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 clique em 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 existir, será possível também abrir o arquivo flow_name_node_name.msgmap no Visualização Desenvolvimento do Broker.

Uma rotina de mapeamento é específica para o tipo de nó com o qual ela está associada; não é possível usar uma rotina de mapeamento que você tenha desenvolvido para um nó DataDelete com um nó diferente que use mapeamentos (por exemplo, um nóDataInsert). Se você criar uma rotina de mapeamento, não é possível chamá-la de outra rotina de mapeamento, embora possa 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 Usando Mapas de Dados Gráficos.

 
Transação Sim Não Automático O modo de transação para o nó. Os valores são:
  • Automático (o padrão). O fluxo de mensagens, do qual o nó DataDelete faz parte, será confirmado se for bem-sucedido, ou seja, as ações definidas nos mapeamentos são desempenhadas e a mensagem continua por meio do fluxo de mensagens. Se o fluxo de mensagens falhar, ele será revertido. Portanto, se você selecionar Automático, a capacidade para confirmar ou recuperar a ação do nó DataDelete no banco de dados depende do sucesso ou da falha de todo o fluxo de mensagens.
  • Consolidar. Para confirmar qualquer ação não confirmada executada nesse fluxo de mensagens no banco de dados conectado a esse nó, independentemente do êxito ou da falha do fluxo de mensagens como um todo, selecione Confirmar (Commit). As alterações no banco de dados serão consolidadas mesmo que o próprio fluxo de mensagens falhe.
 
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ó tratará avisos como códigos de retorno típicos e não irá gerar uma 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 broker 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 desmarcar a caixa de opção, você deverá manipular o erro no fluxo de mensagens para assegurar a integridade do broker e do banco de dados: o erro será ignorado se você não manipulá-lo por meio de seu próprio processamento, porque você escolheu não executar a manipulação de erros padrão pelo broker. Por exemplo, você pode conectar o terminal Failure a uma sub-rotina de processamento de erro.

 

Conectar antes do início do fluxo

Não

Sim

Limpo

Por padrão, o broker se conecta à origem de dados quando necessário em um fluxo de mensagens.

Se você marcar a caixa de seleção, as conexões de origem de dados serão feitas antes de o fluxo receber uma mensagem, em vez de durante o processamento do fluxo de mensagens.

 
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:18


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04680_