可将 Oracle JDBC for OCI 驱动程序与 V7.0 和更高版本的应用程序服务器配合使用。
关于此任务
要在应用程序服务器中创建使用 Oracle 调用接口 (OCI) 的数据源或需要使用 OCI 的 Oracle 功能部件,您必须使用 Oracle JDBC OCI 本机库。可使用应用程序服务器配置任何类型的 Oracle JDBC 提供程序以使用 OCI。
过程
- 在管理控制台中,创建该 JDBC 提供程序。
- 单击资源,展开 JDBC,然后单击
JDBC 提供程序。
- 选择 JDBC 提供程序的范围。 范围可设置为单元、节点或服务器级别。
- 单击新建以创建 JDBC 提供程序。
- 为 JDBC 提供程序配置设置。 此提供程序可用于创建使用 OCI 或瘦 URL 的数据源。所使用的类型取决于 URL 中指定的内容。与 OCI 配合使用时,此提供程序无法与隔离的类装入器配合使用。
- 在“步骤 1:创建新 JDBC 提供程序”面板上选择 Oracle 作为数据库类型。
- 在“步骤 1:创建新 JDBC 提供程序”面板上选择 Oracle JDBC 驱动程序作为提供程序类型。
- 在“步骤 1:创建新 JDBC 提供程序”面板上选择连接池数据源或 XA
数据源作为实现类型。
- 指定 JDBC 提供程序的名称和描述(可选)。
- 单击下一步。
- 在“步骤 2:对数据源输入特定于数据库的属性”面板上,指定 ojdbc6.jar 或 ojdbc7.jar(如果您正在运行 Java 7 或更高版本)Java 归档 (JAR) 文件的目录位置。
最佳实践: 可以在类路径中使用应用程序服务器变量。
例如,您可以在类路径的字段中使用变量 ${ORACLE_JDBC_DRIVER_PATH},但是必须将变量 ORACLE_JDBC_DRIVER_PATH 定义到应用程序服务器。您可以在这个步骤将此变量的值设置为在其中安装 ojdbc JAR 的目录。或者,创建提供程序之后,您可以在相应的作用域级别,通过单击在管理控制台中定义或更改此变量。请将它的值设置为在其中安装 ojdbc JAR 文件的目录。
例如,类路径字段可以包含 ${ORACLE_JDBC_DRIVER_PATH}/ojdbc6.jar,目录位置字段可以包含 /root/InstantClient/12.1.0.1.0。
bprac
- 单击下一步。
- 在“摘要”面板上查看配置,然后单击完成。 如果需要更改配置,请在下一个面板上选择新配置,进行更改,然后单击应用。
- 在应用程序服务器中创建数据源。
- 单击资源,展开 JDBC,然后单击
。
- 在其他属性下,单击。
- 在“步骤 1:输入基本数据源信息”面板上指定数据源的名称。
- 在“步骤 1:输入基本数据源信息”面板上指定数据源的 JNDI 名称。
- 单击下一步。
- 指定数据源从其获取连接的数据库的 URL。在“步骤 2:对数据源输入特定于数据库的属性”面板上指定此信息。
对于 OCI 驱动程序,可以使用下列其中一个示例:
jdbc:oracle:oci:@//mySystem:1521/sample
jdbc:oracle:oci:@sample
- 选择对应所配置 JDBC 提供程序类型的数据存储辅助类的名称。在“步骤 2:对数据源输入特定于数据库的属性”面板上选择此信息。
- 单击下一步。
- 可选: 指定关联安全别名的值。
- 单击下一步。
- 在“摘要”面板上查看配置,然后单击完成。 如果需要更改配置,请在下一个面板上选择新配置,进行更改,然后单击应用。
- 保存配置。
- 执行测试连接。如果测试工作,那么表示配置已完成。如果测试失败并发生链接错误,请继续执行下一步。
- 可选: 设置 JDBC 提供程序上的本机库路径,设置操作系统环境变量,或者设置服务器上的环境变量。
- 首先,尝试设置 JDBC 提供程序上的本机库路径,然后执行测试连接。
要设置本机库路径,请执行下列操作:
- 编辑 JDBC 提供程序
- 使用 Oracle JDBC 驱动程序本机库的路径填写本机库路径。
此路径可能与您用于类路径的路径相同。
最佳实践: 可以在本机库路径中使用应用程序服务器变量。
例如,如果类路径和本机库路径相同,那么您可以使用用于类路径的变量,也可以使用与本机库路径的字段中的 ${ORACLE_HOME} 相似的变量。
然后,必须将变量 ORACLE_HOME 定义到应用程序服务器。在相应的作用域级别,通过单击在管理控制台中定义或更改此变量,并将它的值设置为在其中安装 Oracle 本机客户机库的目录。
例如,如果在其中安装本机库的位置是 lib,那么该字段可以包含 ${ORACLE_HOME}/lib。
bprac
- 如果仍然发生链接失败,那么必须在用来运行 WebSphere Application Server 的操作系统环境中设置 Oracle 本机客户机库的路径,或者在服务器的环境条目中设置这些库路径。 要设置的环境变量是平台类型特定的变量。这些项目可能已在 Oracle 安装过程中进行设置。
- AIX:LIBPATH
- HP-UX:SHLIBPATH
- Linux/Solaris:LD_LIBRARY_PATH
- WINDOWS:PATH
- 可能需要将 TNS_ADMIN 变量设置为包含诸如 tnsnames.ora 或 sglnet.ora 之类文件的路径。 例如,如果 tnsnames.ora 包含某个 URL 中使用的 TNS 服务名称(例如 jdbc:oracle:thin:@mydb)。
- 要设置操作系统环境中的变量,请遵循适用于平台的指示信息进行操作。 例如,对于 AIX,可能使用以下内容:
export LIBPATH=/InstantClient:$LIBPATH
export TNS_ADMIN=/InstantClient
- 要设置服务器上的变量,请使用环境变量。 例如,使用管理控制台:
- 。
- 选择配置选项卡。
- 在服务器基础结构下,展开 Java 和进程管理。
- 选择进程定义,然后在其他属性下面,选择环境条目。
- 添加要设置的每一个环境变量的名称值对。
- 设置相应的环境变量之后,尝试再次测试连接。
- 您将需要先重新启动服务器,然后才能使用应用程序中的数据源。
下一步做什么
请注意以下事项:
- 所安装的 Instant Client 的位级别必须与操作系统的位级别相匹配。
- 所选的 Instant Client 的版本对在其中安装该 Instant Client 的平台必须是正确的。
Instant Client for AIX5L 可以与 AIX 5L 或更高版本配合使用。
- 对于 WebSphere Application Server 所使用的 Java 版本,ojdbc JAR 文件必须是正确的版本。
ojdbc6.jar 可与 Java 6 或 Java 7 配合使用。ojdbc7.jar 只能与 Java 7 配合使用。
- 所使用的 ojdbc JAR 文件应该是随所使用的客户机提供的 ojdbc JAR 文件。