Editor ESQL

O editor ESQL é o editor padrão fornecido pelo para edição de arquivos ESQL (.esql).

O editor é ativado na área do editor quando você seleciona o item de menu Abrir ESQL para um nó Compute, Database ou Filter ou quando você dá um clique duplo em um arquivo ESQL na visualização do navegador.

Visualizações do Editor ESQL

O editor ESQL possui as seguintes visualizações:

Visualização Navegador de Recursos
A visualização do navegador mostra todos os recursos em um espaço de trabalho, que são todos os recursos do conjunto de mensagens e todos os recursos do fluxo de mensagens, incluindo arquivos ESQL.
Visualização Editor
A visualização do editor mostra o conteúdo do recurso que está atualmente aberto. Também mostra as guias para cada recurso que você tem aberto para que possa rapidamente comutar entre eles.
Visualização Contorno
A visualização Contorno exibe todos os esquemas, as limitações definidas, módulos e rotinas que você referenciou nesse arquivo ESQL.
Visualização Tarefas
A visualização tarefas exibe o aviso e as mensagens de erro que são geradas pela validação do editor quando você salva o arquivo ESQL. Se você der um clique duplo em um erro, o editor indicará onde está localizado, destacando o código ESQL correspondente.

Funções do Editor ESQL

O editor ESQL fornece:

  • Um Assistente de Conteúdo dependente de contexto. Você pode chamar o Assistente de Conteúdo a partir do menu Editar ou, em alguns sistemas, pressionando Ctrl+Espaço se esta combinação de teclas não estiver atribuída a outra função.

    O Assistente de Conteúdo ajuda a construir referências ao conteúdo da pasta Propriedades. Quando você utiliza o editor ESQL com mensagens predefinidas, isso também o ajuda a construir as referências de campo.

    Ao utilizar o editor ESQL com as definições do esquema de banco de dados, o Assistente de Conteúdo o ajuda a construir referências de esquema, tabela e coluna. Você também pode utilizar o editor ESQL para chamar mapas definidos pelo usuário.

    Ao criar funções e procedimentos dentro do arquivo ESQL, os nomes que você define não devem iniciar com os caracteres IBM_ (IBM e sublinhado).

  • Formatação de código automática.

Clique com o botão direito na visualização do editor para acessar as seguintes funções adicionais:

  • Desfazer e Reverter. Para desfazer uma alteração feita no arquivo ESQL, clique em Desfazer. Se você desfizer uma alteração, poderá refazê-la, clicando em Reverter.
  • Recortar, Copiar e Colar. Essas são as funções padrão do editor.
  • Shift à Direita e Shift à Esquerda. Essas são as funções padrão do editor.
  • Salvar. Clique nessa opção para salvar suas alterações.
  • Comentar e Remover Comentário. Clique em Comentar para alterar uma linha de código ESQL em um comentário. Clique em Remover Comentário para alterar um comentário em uma linha de código ESQL.
  • Formatar. Essa função formata todas as linhas de código selecionadas (a menos que apenas parcialmente selecionadas, quando são ignoradas) ou, se nenhuma linha estiver selecionada, formata todo o arquivo (corrigindo alinhamentos e recuo).
  • Organizar Caminhos do Esquema e Incluir Caminho do Esquema. Essas funções ajudam no gerenciamento de esquemas do intermediário.

    Clique em Organizar Caminhos do Esquema e qualquer esquema do intermediário contendo procedimentos ou uma função chamada pelo arquivo ESQL é automaticamente adicionado à instrução PATH (se ainda não adicionou). Essa função varre o arquivo ESQL em busca de instâncias de procedimentos ou de função residente em esquemas ainda não totalmente qualificados no arquivo.

    Clique em Incluir Caminho do Esquema quando codificar uma chamada para um procedimento ou função residente em um esquema de intermediário diferente e para qualquer procedimento ou função na instrução PATH e este esquema é adicionado à instrução PATH. Assegure-se de que o cursor esteja sobre o nome do procedimento que está sendo chamado.

Preferências do Editor ESQL

É possível modificar as definições que afetam a maneira como o código ESQL é manipulado:

  • Definições de Geração de Código (qual código de tempo de execução é gerado):
    O nome do esquema utilizado para acessar as tabelas RDB
    Selecione um dos seguintes botões de opções para especificar o esquema que é utilizado quando você inclui uma referência em uma tabela de banco de dados no seu ESQL:
    Utilize o esquema de tempo de execução padrão para essa origem de dados
    Se você selecionar essa opção, será utilizado o esquema padrão para a origem de dados.
    Utilize o nome do esquema na definição da tabela
    Se selecionar essa opção, será utilizado o esquema que você especificou quando criou a definição da tabela.
    Utilizar Nome Especificado
    Se selecionar essa opção, será utilizado o nome do esquema que você digitou no campo de entrada de texto associado.
    Nível de Compatibilidade Padrão
    Selecione 5.0 ou 2.1 na lista drop-down:
    5.0
    Se você selecionar esse valor, um fluxo de mensagens compilado pode ser implementado somente nos intermediários Versão 5.0, porque o código de tempo de execução ESQL que foi gerado não é compatível com as versões anteriores. Se você deseja depurar o código ESQL dentro dos seus fluxos de mensagens, essa definição é necessária. Ela também é necessária se seu fluxo de mensagens inclui nós que tenham arquivos de mapeamento (.mfmap). Se você definiu esse valor e implementar um arquivo bar que contenha um fluxo de mensagens que inclua a Versão 5.0 do código do tempo de execução ESQL para um intermediário Versão 2.1, o intermediário vai gerar um erro ao iniciar o fluxo de mensagens.

    Essa é a definição padrão.

    2.1
    Você deve selecionar esse valor se desejar implementar o fluxo de mensagens nos intermediários Versão 2.1. Você também pode implementar esses fluxos de mensagens nos intermediários Versão 5.0, mas deve assegurar-se de não incluir nenhum conteúdo que seja específico da Versão 5.0 (por exemplo, um arquivo de mapeamento ou uma instrução BROKER SCHEMA). Se você tiver definido esse valor e implementar um arquivo bar que contém um fluxo de mensagens que inclui a Versão 5.0 do código do tempo de execução ESQL, a implementação falhará.

    Se alterar essa definição de 5.0 para 2.1, ou de 2.1 para 5.0, você deve reconstruir cada projeto de fluxo de mensagens no seu espaço de trabalho. Se você não fizer isso, pode receber erros ao implementar o arquivo bar que contém um ou mais desses fluxos de mensagens.

  • Definições do Editor (como o código é exibido na visualização do editor):
    • Fonte de Texto
    • Largura da Guia Exibida (padrão 4)
    • Cores de Primeiro e Segundo Plano (para comentários, instruções e assim por diante)
  • Definições de Validação (qual nível de validação é executado quando você salva o arquivo):

    A validação detecta quatro problemas potenciais:

    Identificadores não-resolvidos
    O validador tenta resolver qualquer identificador que você tenha referenciado (por exemplo, um campo de mensagem).
    Definição da Mensagem de Incompatibilidade de Referências de Mensagens
    Se existe uma definição de mensagem (somente mensagens no domínio MRM), o validador verifica se o uso da referência é consistente com sua definição (por exemplo, uma ação em um campo numérico é uma ação numérica válida).
    Referências do Banco de Dados Incompatíveis com o Esquema do Banco de Dados
    O validador verifica se o uso da referência é consistente com o esquema de banco de dados (por exemplo, uma ação em um campo numérico é uma ação numérica válida).
    Uso de palavras-chave obsoletas
    O validador verifica se você utilizou qualquer palavra-chave que tenha sido reprovada neste release.

    Para cada uma destas situações, selecione uma das seguintes definições de validação:

    Ignorar
    A operação não foi executada.
    Aviso
    O validador grava mensagens de aviso para a visualização Tarefa para cada problema em potencial que é detectado. Essa é a definição padrão.
    Erro
    O validador grava mensagens de erro para a visualização Tarefa para cada problema potencial que é detectado.

    A validação não verifica se você possui nomes especificados no caso no qual os declarou. Os nomes de módulos, funções e procedimentos não fazem distinção entre maiúsculas e minúsculas; todos os outros nomes (esquemas, constantes, variáveis e rótulos) fazem distinção entre maiúsculas e minúsculas. Verifique se os nomes que você utiliza correspondem às declarações para esses nomes porque o intermediário os trata fazendo distinção entre maiúsculas e minúsculas e gerará um erro de tempo de execução se não corresponderem.

Para obter detalhes sobre como alterar essas preferências, consulte Alterando Preferências do ESQL.

Barra de Ferramentas do Editor ESQL

O editor ESQL não fornece nenhum ícone e ação adicionais na barra de ferramentas.

Tarefas relacionadas
Desenvolvendo ESQL
Alterando Preferências do ESQL

Referências relacionadas
instruções ESQL
Funções ESQL

Preferências e Definições Localizadas do Editor