ESQL 编辑器

ESQL 编辑器是“代理应用程序开发”透视图提供的缺省编辑器,用于编辑 ESQL(.esql)文件。

当您对 Compute、Database 或 Filter 节点选择菜单项打开 ESQL,或在导航器视图中双击 ESQL 文件时,将在编辑器区域中启动此编辑器。

ESQL 编辑器视图

ESQL 编辑器具有以下视图:

资源导航器视图
导航器视图显示工作空间中的所有资源,也就是所有消息集资源和所有消息流资源,包括 ESQL 文件。
编辑器视图
编辑器视图显示当前打开的资源的内容。它还显示已打开资源的选项卡,这样您可以在它们之间快速切换了。
大纲视图
大纲视图显示该 ESQL 文件中引用的任何模式、定义的常量、模块和例程。
任务视图
任务视图显示的是警告与错误消息,它们都是在您保存 ESQL 文件时,编辑器验证之后生成的。如果双击某个错误,编辑器会通过突出显示对应的 ESQL 代码来指出错误所在的位置。

ESQL 编辑器功能

ESQL 编辑器提供:

  • 上下文有关的内容辅助。您可以从“编辑”菜单或在有些系统上通过按 Ctrl+Space(如果它没有分配为另一个功能)来调用内容辅助。

    内容辅助有助于您构造对“属性”文件夹内容的引用。当您对预定义消息使用 ESQL 编辑器时,内容辅助还有助于您构造字段引用。

    当您对数据库模式定义使用 ESQL 编辑器时,内容辅助有助于您构造模式、表和列引用。您也可以使用 ESQL 编辑器调用用户定义的映射。

    在 ESQL 文件中创建函数和过程时,您定义的名称不能以字符 IBM_(IBM 下划线)开头。

    注: 要使内容辅助起作用,您必须设置从包含 ESQL 或映射的项目到包含消息集的项目的项目引用。有关设置项目引用的信息,请参阅项目引用
  • 自动代码格式化。

在编辑器视图中右键单击以访问以下功能:

  • 撤销还原。要撤销您对 ESQL 文件所做的更改,单击撤销。如果要撤销更改,可以通过单击还原来复原。
  • 剪切复制粘贴。这些是标准的编辑器功能。
  • Shift 加向右箭头Shift 加向左箭头。这些是标准的编辑器功能。
  • 保存。单击它以保存您的更改。
  • 注释取消注释。单击注释以将 ESQL 代码的一行更改为注释。单击取消注释以将注释更改为一行 ESQL 代码。
  • 格式化。此功能格式化所有选择的代码行(除非部分选择,当它们被忽略时)或者如果没有选择行,格式化整个文件(改正对齐和缩进)。
  • 组织模式路径添加模式路径。这些功能帮助您进行代理模式管理。

    单击组织模式路径,任何包含 ESQL 文件调用的过程或函数的代理模式自动添加到 PATH 语句(如果您还没有添加它)。此功能扫描 ESQL 文件以查找过程或函数实例,它们驻留在未在该文件中全限定的模式中。

    当您将在其他代理模式中过程或函数的调用编码到在 PATH 语句中包含的任何代理模式时,单击添加模式路径,且此模式将添加到 PATH 语句。确保光标在您调用的过程的名称上。

ESQL 编辑器首选项

可修改影响 ESQL 代码处理方式的设置:

  • 代码生成设置(生成何种运行时代码):
    用于访问 RDB 表的模式名称
    选择以下某个单选按钮,以指定您在 ESQL 中包含数据库表引用时所使用的模式:
    为该数据源使用缺省运行时模式
    如果选择该按钮,则使用数据源缺省模式。
    使用表定义中的模式名称
    如果选择该按钮,则使用您创建表定义时指定的模式。
    使用指定的名称
    如果选择该按钮,则使用您输入关联文本输入字段的模式名称。
    缺省兼容性级别
    从下拉列表选择 5.0 或 2.1:
    5.0
    如果选择该值,则已编译消息流仅可部署到代理 V5.0,因为生成的运行时 ESQL 代码与先前版本不兼容。如果要在消息流中调试 ESQL 代码,该设置是必需的。如果您的消息流包含拥有映射(.mfmap)文件的节点,也需要该设置。如果设置了该值,并将包含消息流(包含 V5.0 运行时 ESQL 代码)的 BAR 文件部署到代理 V2.1,则代理会在启动该消息流时生成错误。

    这是缺省设置。

    2.1
    如果要将消息流部署到代理 V2.1,必须选择该值。也可以将这些消息流部署到代理 V5.0,但必须确保没有包含任何特定于 V5.0 的内容(例如,映射文件或 BROKER SCHEMA 语句)。 如果设置了该值,并且部署了包含消息流(包含 V5.0 运行时 ESQL 代码)的 BAR 文件,则部署失败。

    如果将该设置从 5.0 更改为 2.1,或从 2.1 更改为 5.0,必须在您的工作空间中重建每个消息流项目。如果未执行该操作,则可能在部署 BAR 文件(包含这些消息流中的一个或多个)时接收到错误消息。

  • 编辑器设置(编辑器视图中如何显示代码):
    • 文本字体
    • 显示的选项卡宽度(缺省值 4)
    • 背景色和前景色(针对注释、语句等)
  • 验证设置(保存文件时执行哪个级别的验证):

    验证检测 4 个潜在问题:

    未解析的标识
    验证器尝试解析已引用的所有标识(例如,消息字段)。
    消息引用与消息定义不匹配
    如果消息定义存在(仅 MRM 域中的消息),验证器会检查引用的使用是否与消息定义一致(例如,对数字字段的操作为有效数字操作)。
    数据库引用与数据库模式不匹配
    验证器会检查引用的使用是否与数据库模式一致(例如,对数字字段的操作为有效数字操作)。
    使用了不推荐的关键字
    验证器检查您是否使用了任何该发行版中不推荐使用的关键字。

    针对以上每种情况,选择以下某个验证设置:

    忽略
    不执行验证。
    警告
    验证器针对它检测到的每个潜在问题,将警告消息写入任务视图。这是缺省设置。
    错误
    验证器针对它检测到的每个潜在问题,将错误消息写入任务视图。

    如果您声明了名称,则验证将不检查是否已指定名称。模块、函数和过程的名称不区分大小写;所有其他名称(模式、常量、变量和标签)都区分大小写。检查所用名称是否与这些名称的声明相匹配;因为代理是以区分大小写的方式处理这些名称的,如果不匹配便会生成运行时错误。

有关如何更改这些首选项的详细信息,请参阅更改 ESQL 首选项

ESQL 编辑器工具栏

ESQL 编辑器在工具栏上不提供任何附加的图标和操作。

相关概念
项目引用
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
ab00083_