Criando um Arquivo ESQL

Ao incluir um nó em seu fluxo de mensagens que exija ESQL para customizar sua função (os nós Compute, Banco de Dados, DatabaseInput e Filter), será necessário codificar as instruções ESQL que fornecem a customização em um módulo ESQL em um arquivo ESQL. É possível usar o mesmo arquivo ESQL para mais de um módulo.

Antes de começar:

Para informações práticas, consulte Visão Geral do ESQL.

Para concluir esta tarefa, você deve ter criado um projeto de fluxo de mensagens para conter seu arquivo ESQL.

Os arquivos ESQL são armazenados em um sistema de arquivos ou em um repositório compartilhado. Se estiver usando um sistema de arquivos, você poderá usar o sistema de arquivos local ou uma unidade compartilhada. Se você armazenar arquivos em um repositório, poderá utilizar qualquer dos repositórios disponíveis que são suportados pelo Eclipse, por exemplo, CVS.

Para criar um arquivo ESQL, conclua as etapas a seguir.

  1. Clique em Arquivo > Novo > Arquivo ESQL do Fluxo de Mensagens.

    Também é possível pressionar Ctrl+N. É aberta uma caixa de diálogo na qual é possível selecionar o assistente para criar um novo objeto. Clique em Message Brokers; uma lista de objetos que é possível criar para o WebSphere Message Broker é mostrada. Clique em Arquivo ESQL do Fluxo de Mensagens e, em seguida, clique em Avançar.

    O assistente Novo Arquivo ESQL do Fluxo de Mensagens é aberto.
  2. Insira o nome do projeto do fluxo de mensagens no qual criar o arquivo ESQL.

    Você deve inserir o nome de um projeto do fluxo de mensagens existente. A caixa de diálogo é aberta com o nome do projeto atual inserido no campo de nome do projeto. Você pode aceitar este valor ou alterá-lo para especificar um projeto diferente. Também é possível clicar em Navegar para visualizar uma lista de projetos válidos (projetos que são definidos e mostrados na visualização Navegador) e selecionar o valor apropriado dessa lista. A lista é filtrada para mostrar apenas projetos no conjunto de trabalhos ativo.

    Se você digitar o nome de um projeto que não existe, a mensagem de erro O projeto especificado não existe será mostrada na caixa de diálogo e não será possível continuar até que você especifique um nome de projeto válido.

  3. Se você desejar que o arquivo ESQL seja definido em um esquema do broker específico, insira o nome do esquema do broker no campo de entrada apropriado ou clique em Procurar para selecionar o esquema do broker na lista de esquemas do broker válidos deste projeto. (Se o esquema do broker padrão for o único definido neste projeto, Procurar estará desativado).
  4. Insira um nome para o novo arquivo ESQL. Se você inserir um nome que já esteja em uso para um arquivo ESQL neste projeto, a mensagem de erro O recurso <nome>.esql já existe será mostrado e você deverá especificar um nome diferente.

    Ao criar arquivos ESQL, o comprimento global do caminho do arquivo não deverá exceder 256 caracteres, devido a uma limitação do sistema de arquivos do Windows. Se você tentar incluir um fluxo de mensagens em arquivo bar com ESQL ou arquivos de mapeamento com comprimento de caminho que excede 256 caracteres, o fluxo de mensagens compilado não será gerado e não poderá ser implementado. Portanto, assegure-se de que os nomes de seus arquivos ESQL, arquivos de mapeamento, projetos e esquema do broker são os menores possíveis.

  5. Clique em Concluir.

O arquivo ESQL é aberto no editor, em que você pode editar o arquivo e, em seguida, salvá-lo.

Um arquivo ESQL também pode ser criado automaticamente. É possível clicar com o botão direito do mouse em um nó Compute, Banco de Dados, DatabaseInput ou Filter e, em seguida, clicar em Abrir ESQL. Se o módulo identificado pela propriedade apropriada ainda não existir no esquema do broker, um módulo será criado automaticamente. Esse módulo é criado no arquivo <message_flow_name>.esql no mesmo esquema do broker no mesmo projeto do arquivo <message_flow_name>.msgflow. Se esse arquivo ESQL ainda não existir, ele também será criado.

O conteúdo de um único arquivo ESQL não possui nenhum relacionamento específico com fluxos de mensagens e nós. É sua a decisão sobre quais módulos serão criados e em quais arquivos (a menos que o módulo especificado, identificado pela propriedade apropriada, seja criado, por padrão, no arquivo <nome_do_fluxo_de_mensagens>.esql conforme descrito acima). Monitore o tamanho e a complexidade do ESQL em cada arquivo e divida o arquivo se ele se tornar difícil de visualizar ou gerenciar.

Se você criar sub-rotinas reutilizáveis (no nível do esquema do broker) em um arquivo ESQL, talvez queira consultar essas rotinas nos módulos ESQL em outro projeto. Para consultar as rotinas, especifique que o projeto em que deseja executar as sub-rotinas depende do projeto no qual o arquivo ESQL que as contém está definido. É possível especificar esse comportamento ao criar o segundo projeto ou é possível atualizar as dependências do projeto selecionando o projeto, clicando em Propriedades e atualizando as dependências na página Referência do Projeto da caixa de diálogo Propriedades.

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

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:48:37


Tópico de TarefaTópico de Tarefa | Versão 7.0.0.5 | ak09031_