第三章 使用 SQL 网关访问数据库 - 使用链接表向导

第三章 使用 SQL 网关访问数据库 - 使用链接表向导

使用链接表向导

当链接到外部表或视图时，将创建链接到该表或视图的持类。类使用 SQL 网关从外部源存储和检索数据。

注意：此向导使用控制的类名和类成员名生成 ObjectScript 代码。使用此向导时，请务必遵循 ObjectScript 标识符的规则，包括长度限制。

• 如果尚未创建与外部数据库的连接，请在开始之前执行此操作。

• 从管理门户中选择“系统资源管理器”，然后选择“SQL”。使用页面顶部的 Switch 选项选择一个命名空间；这将显示可用命名空间的列表。
  在页面顶部，单击“向导”下拉列表，然后选择“链接表”。

• 在向导的第一页上，选择一个或多个表或视图，如下所示：

  • 选择目标命名空间 — 选择数据将复制到的 IRIS 命名空间。
  • 架构过滤器 - 指定包含表或视图的架构（类包）名称。可以指定带有通配符的名称以返回多个架构，或指定 % 以返回所有架构。例如，C% 将返回命名空间中以字母 C 开头的所有模式。建议使用此过滤器，因为它将缩短可供选择的模式的返回列表，从而提高加载速度。您可以选择多个项目。在这种情况下，当您单击“下一步”时，下一个屏幕会提示输入包名称。指定包含类的包的名称，然后单击“完成”。
  • 表过滤器 - 指定要链接到的表或视图。可以指定带有通配符的名称以返回多个表和/或视图，或指定 % 以返回所有表/视图。
  • 表类型 — 选择表、视图、系统表或全部。默认为表。
  • 选择 SQL 网关连接 — 选择要使用的 SQL 网关连接。

• 点击下一步。

• 在第二页上，指定哪些字段应可用作中的对象属性。进行如下更改：

• 突出显示一个或多个字段，然后单击单箭头将其从一个列表移动到另一个列表；单击双箭头可将所有字段（选定或未选定）从一个列表移动到另一个列表。

• 在选定的列表中，使用向上和向下箭头修改给定类项目的表中字段的顺序。这不会影响类定义中属性的顺序。

• 点击下一步。

• 在第三页上，指定有关生成的类中的属性的信息。对于每个属性，可以指定所有可用选项：

  • 只读 - 选中此复选框可使属性变为只读。这控制属性的 ReadOnly 关键字。

  提示：使用 select_all 复选框可选择或清除此列中的所有复选框。

  • 新属性名称 - 指定将包含此字段中的数据的对象属性的名称。
  • 新列名称（SQL 字段名称）— 指定用于此属性的 SQL 字段名称。这控制属性的 SqlFieldName 关键字。

• 点击下一步。

• 在最后一页上，指定以下内容：

  • 主键 — 从提供的列表中选择新表的主键。除了提供的默认键外，您还可以单击“浏览”按钮来选择一列或多列。可以选择多列；多列作为复合键返回，以逗号分隔。必须指定一个主键。
  • 新类名称 - 指定要创建的类的名称，包括包。默认包名称为 nullschema。
  • 新表名称 - 指定要在中创建的 SQL 表的名称。这控制类的 SqlTableName 关键字。

• 单击“完成”。该向导显示“后台作业”页面，其中包含指向后台任务页面的链接。

• 单击“关闭”。或者单击给定的链接查看后台任务页面。无论哪种情况，向导都会启动后台任务来完成工作。

该向导将新的类定义存储在数据库中并对其进行编译。如果数据存在，它应该立即在外部数据库中可见（可以通过针对新创建的 类/表发出SQL 查询来进行检查）。现在，可以像使用中的任何其他持久类一样使用新类。

注意：关闭链接表连接 根据设计，链接表向导生成的代码不会关闭它打开的连接。这样可以避免共享同一连接的 SQL 语句之间发生冲突等问题。