Warehouse

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

Propósito

O nó Warehouse é um formato especializado do nó Banco de Dados que armazena a mensagem inteira e/ou partes da mensagem em uma tabela dentro do banco de dados. Você define o que é armazenado criando mapeamentos que utilizam dados da mensagem de entrada para identificar a ação necessária.

Você pode utilizar o nó Warehouse:

  • Para manter uma trilha de auditoria das mensagens que estão passando pelo intermediário
  • Para processamento off-line ou em lote das mensagens que passaram pelo intermediário (mineração de dados)
  • Como uma origem da qual reprocessar mensagens selecionadas no intermediário

Utilize técnicas de consulta e mineração de banco de dados padrão para recuperar mensagens armazenadas no armazém. (Nenhum suporte explícito é fornecido pelo WebSphere Message Broker.)

Você deve ter criado ou identificado os seguintes itens:

  • Dados de entrada no formato de um conjunto de mensagens e de uma mensagem
  • Uma conexão ODBC com o banco de dados
  • Um banco de dados e uma tabela de banco de dados para armazenar a mensagem
  • Pelo menos duas colunas na tabela: uma para o objeto binário (a mensagem) e uma para o registro de data e hora

O nó Warehouse está contido no repositório Banco de Dados da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

Ícone do nó Warehouse

Utilizando este nó em um fluxo de mensagens

Quando você utilizar o nó Warehouse, pode optar por armazenar os seguintes elementos no banco de dados que está associado ao nó:
  • A mensagem inteira, opcionalmente, com uma data e hora associadas. A mensagem é armazenada como um objeto binário, com a data e hora em uma coluna separada. Essa opção tem duas vantagens:
    • Não será necessário decidir antecipadamente como você utilizará os dados do armazém; como você armazenou todos eles, poderá recuperar todos os dados e aplicar as ferramentas de mineração de dados a eles posteriormente.
    • Não é necessário definir um esquema de banco de dados específico para cada tipo de mensagem que poderá passar pelo intermediário. Em um sistema complexo, diferentes tipos de mensagens poderão ser processados, e a sobrecarga da definição de um esquema exclusivo para cada tipo de mensagem pode se tornar proibida. Você pode preceder cada nó Warehouse com o nó Compute que converte cada mensagem em um formato de armazém canônico com um esquema comum, ou pode armazenar a mensagem inteira como um objeto binário.
  • Partes selecionadas da mensagem, opcionalmente com um registro de data e hora associado, que exige um esquema de banco de dados definido para esse tipo de mensagem. A mensagem é mapeada para tipo true, portanto, por exemplo, uma cadeia de caracteres na mensagem é armazenada como uma cadeia de caracteres no banco de dados.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Warehouse 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 em um nó Warehouse, você abre a caixa de diálogo Novo Mapa de Mensagens.) 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ó Warehouse 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ó Warehouse são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não Warehouse 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ó Warehouse 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 as quais você consulta nos mapeamentos associados a esse nó (identificado pela propriedade Mapeamento de Campo). O 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.

z/OS platform Nos sistemas z/OS, o intermediário utiliza o ID da tarefa iniciada do intermediário ou o ID do usuário e senha especificados na JCL de comando do mqsisetdbparms, BIPSDBP no conjunto de dados de customização <hlq>.SBIPPROC.

Mapeamento de campo Sim Não Warehouse O nome da rotina de mapeamento que contém as instruções que são executadas no banco de dados ou à árvore de mensagens.

Por padrão, o nome que é designado à rotina de mapeamento é idêntico ao nome do arquivo de mapeamentos no qual a rotina está definida e 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_Warehouse.msgmap para o primeiro nó Warehouse no fluxo de mensagens MFlow1). Você não pode especificar um valor que inclui espaços.

Se você clicar em Procurar (Browse) 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 Mapeamento de Campo.

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.

O conteúdo da rotina de mapeamento determina o que é armazenado no banco de dados e em qual formato. Você pode, por exemplo, armazenar toda ou apenas uma parte de cada mensagem. Além disso, você pode armazenar os dados como dados binários, ou armazenar cada campo no mesmo formato que estão na mensagem (por exemplo, um campo de caractere na mensagem é armazenado como caractere no banco de dados).

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ó Warehouse com qualquer outro nó que utiliza mapeamentos (por exemplo, um nó DataInsert). 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ó. Selecione o valor que você requer:
  • Se você selecionar Automático (o padrão), o fluxo de mensagens, do qual o nó Warehouse faz parte, é confirmado se ele for bem-sucedido; isto é as ações que você define nos mapeamentos são realizadas e a mensagem continua pelo fluxo de mensagens. Se o fluxo de mensagens falhar, ele será revertido. Portanto, selecionar Automático significa que a capacidade de confirmar ou recuperar a ação do nó Warehouse no banco de dados depende do sucesso ou da falha do fluxo de mensagens inteiro.
  • Se você selecionar Confirmar (Commit), toda ação não confirmada executada nesse fluxo de mensagens será confirmada no banco de dados conectado a esse nó, independentemente do êxito ou da falha do fluxo de mensagens como um todo. 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 Failure, 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 erros do banco de dados. A caixa de opção é selecionada por padrão.

Se você desmarcar a caixa de opção, 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 optou por não chamar o tratamento de erros padrão pelo intermediário; por exemplo, você pode conectar o terminal Failure a uma sub-rotina de processamento de erro.

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

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:43

ac04730_