配置数据源 JDBC 提供程序以在 Java SE 环境中使用 pureQuery

使用此任务配置应用程序数据源 Java™ 数据库连接 (JDBC) 提供程序以使用 pureQuery 访问 Java Standard Edition (Java SE) 环境中的 DB2®。此配置适用于 Java™ 持久性 API (JPA) 2.0 规范提供程序 WSJPA。

开始之前

如果需要使用多个 DB2 程序包集合,那么在继续执行本任务之前,请参阅信息中心主题“配置 pureQuery 以使用多个程序包集合”。

关于此任务

IBM® Optim™ pureQuery Runtime 使用 DB2 包。这些包包括一个或多个结构化查询语言 (SQL) 语句的信息,并且存储在 DB2 目录中。必须先对 Java 持久性 API (JPA) 应用程序运行 wsdbgen 命令才能创建包。wsdbgen 命令将创建一个包含 SQL 语句信息的 XML 文件。这个 XML 文件必须包括在应用程序 Java 归档 (JAR) 文件中。DB2 绑定命令将使用此文件作为输入,以便创建 DB2 程序包。
要点:
  • JPA 将 IBM Optim pureQuery Runtime 属性 pdq.executionMode 设置为值 STATIC
  • 类路径必须包括 IBM Optim PureQuery 运行时的安装位置。有关更多信息,请参阅有关安装 IBM Optim pureQuery Runtime 的信息中心主题。
  • JPA 提供程序实现必须是应用程序服务器的 JPA (com.ibm.websphere.persistence.PersistenceProviderImpl)。OpenJPA 和 EclipseLink 持久性提供程序未提供对 pureQuery 的支持。
  • wsdbgen 命令需要数据库的 URL。wsdbgen 命令强制执行同步映射功能,此功能将创建或更改所需的表。对于 DB2 zOS,在执行 wsdbgen 命令之前,必须手动创建 V8 唯一索引和 LOB 表。
请在应用程序 JAR 文件的 META-INF 目录中的 pdq.properties 文件中指定 IBM Optim pureQuery Runtime 属性。对于 JPA 应用程序,pdq.ExecutionMode 属性缺省为 STATIC。可使用 pdqProperties 属性以在动态方式下使用 pureQuery。有关更多信息,请参阅信息中心主题“以动态方式使用 pureQuery”。如果指定了 PDQ 属性,那么这些属性会传递至 IBM Optim PureQuery Runtime。有关属性及有效值的列表,请参阅 IBM Optim pureQuery Runtime 文档。
  • wsjpa.jdbc.CollectionId:此字符串值指定要使用的集合标识。此参数覆盖执行 wsdbgen 期间使用的所有集合标识。
注意: 请参阅 IBM 支持 Web 站点(IBM Optim PureQuery Runtime for Linux, UNIX, and Windows 的系统要求)上有关 IBM Optim pureQuery Runtime 的 DB2 JAR 级别合规性的更多信息。

过程

  1. 更新应用程序数据源 JDBC 提供程序配置,以便包括 IBM Optim pureQuery Runtime JAR 文件。 除了将 JDBC 驱动程序 JAR 文件包括在类路径中以外,还将 pdq.jarpdqmgmt.jar 文件包括在类路径中。定义新的 JDBC 提供程序,或者将现有提供程序修改为包括 JAR 文件。类路径必须包括 IBM Optim PureQuery 运行时的安装位置。有关更多信息,请参阅有关 JDBC 提供程序设置和安装 IBM Optim pureQuery Runtime 的信息中心主题。
  2. 使用 IBM Optim pureQuery Runtime 提供的 DB2 绑定命令将 XML 文件与数据库绑定。这将创建 DB2 程序包。 有关更多信息,请参阅有关 pureQuery 绑定实用程序的信息中心主题。

下一步做什么

如果要为 JDBC 重新配置数据源,请从类路径中除去 pdq.jarpdqmgmt.jar

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_configpdqjpase
文件名:tejb_configpdqjpase.html