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.
Para informações práticas, consulte Visão Geral do ESQL.
Opcional: É possível criar um aplicativo, uma biblioteca ou um Projeto do Message Broker antes de criar um arquivo ESQL. Alternativamente, é possível criar o projeto que o contém ao criar o 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.
O arquivo ESQL é aberto no editor, em que você pode editar o arquivo e, em seguida, salvá-lo. O arquivo ESQL é mostrado na Visualização Desenvolvimento do Broker, abaixo da pasta ESQLs do aplicativo, da biblioteca ou do Projeto do Message Broker que o contém.
Um arquivo ESQL também pode ser criado automaticamente. É possível clicar com o botão direito 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 você pode criar uma referência do projeto; consulte Incluindo e Removendo Referências da Biblioteca.