配置 JDBC 提供程序和数据源
要访问关系数据库,应用程序将使用您为应用程序服务器配置的 Java™ 数据库连接 (JDBC) 驱动程序和数据源。
开始之前
- 数据源 (WebSphere® Application Server V4)(不推荐使用)与 Enterprise JavaBeans (EJB) 1.0 规范和 Java Servlet 2.2 规范配合使用。
不推荐使用的功能部件: depfeat - 最新标准版的数据源与实现了这些更高级发行版规范的应用程序配合使用。
过程
- 验证应用程序服务器上是否安装了所有必需的 JDBC 驱动程序文件。 有关该信息,请参阅“数据源必需设置(按供应商排序)”一文。如果您选择配置用户定义的 JDBC 提供程序,请查阅数据库文档以了解有关驱动程序文件的信息。
- 创建 JDBC 提供程序。
当您从管理控制台中创建 JDBC 提供程序时,请参阅“使用管理控制台配置 JDBC 提供程序”主题;或者
如果您使用 wsadmin 脚本编制客户机,请参阅“通过进行脚本编制来配置 JDBC 提供程序”主题;或者
如果正在使用 Java 管理扩展 (JMX) API,请参阅“使用 Java 管理扩展 API 来创建 JDBC 提供程序和数据源”主题。
- 创建数据源。
在管理控制台中,请参阅“使用管理控制台来创建数据源”主题;或者
如果您使用 wsadmin 脚本编制客户机,请参阅“通过进行脚本编制来配置新数据源”主题。对于 V4 数据源,请参阅“通过进行脚本编制来配置新的 WAS40 数据源”主题(不推荐使用);或者
如果正在使用 JMX API,请参阅“使用 Java 管理扩展 API 来创建 JDBC 提供程序和数据源”主题。
必需属性: 不同的数据库供应商在其 JDBC 驱动程序实现中需要使用不同的属性。请对 WebSphere Application Server 数据源设置这些属性。因为应用程序服务器包含适用于许多供应商 JDBC 实现的模板,所以管理控制台会显示必需的属性,并在您创建数据源时就提示您设置这些必需属性。但是,如果您编写数据访问配置脚本,那么必须参阅“数据源必需设置(按供应商排序)”一文以了解必需的属性和设置选项。 - 可选: 配置定制属性。
必须对应用程序服务器数据源设置适用于特定供应商 JDBC 驱动程序的定制属性,该属性在这一点上类似于必需属性。有关可用的定制属性的信息,请参阅数据库文档。要配置定制类以方便处理 Application Server 本来无法识别的数据库属性,请参阅“开发定制 DataStoreHelper 类”主题。
还有您可能想要进行配置的可选数据源属性,例如,DB2 sslConnection 定制属性。如果您使用 DB2 JDBC 驱动程序提供程序,那么可以在适用于所用 DB2 for z/OS® 版版本的《Application Programming Guide and Reference for Java》中了解有关这些定制属性的更多信息。
- 将资源引用与数据源绑定。请参阅“企业 Bean 和 Web 模块的数据源查找”一文。
- 测试连接(用于非容器管理的持久性用法)。 请参阅“测试连接服务”主题。
结果
即使您接收到有关凭证错误的信息,也请您检查数据库和 JDBC 跟踪日志。这些日志提供有关认证失败的更为可靠且详细的错误数据。
最佳实践: 仅当 JDBC 跟踪服务在服务器启动期间处于活动状态时,JDBC 跟踪日志才存在。请在管理控制台中激活此服务。有关更多信息,请参阅“在服务器启动时启用跟踪”主题。请指定 WAS.database
作为跟踪组并选择 com.ibm.ws.db2.logwriter 作为跟踪字符串。bprac子主题
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
按供应商排序的数据源最小必需设置
根据 Java 数据库连接 (JDBC) 驱动程序实现的数据库供应商要求,这些属性各不相同。您必须对配置的每个数据源设置适当的属性。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Apache Derby 的数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Apache Derby 数据源。
使用 AIX、HP-UX、Linux、Solaris 或 Windows 上的应用程序服务器的 DB2 的数据源最小需求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置适用于连接到运行在 AIX®、HP-UX、Linux、Solaris 或 Windows 系统上的应用程序服务器的 DB2 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
适用于 IBM i 的DB2 通用数据库数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 DB2 UDB 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Informix 的数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Informix® 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Microsoft SQL Server 的数据源最小要求设置
根据 Java 数据库连接 (JDBC) 驱动程序实现的数据库供应商要求,这些属性各不相同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Microsoft SQL Server 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Oracle 的数据源最小必需设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Oracle 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Sybase 的数据源最小必需设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Sybase 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用管理控制台来配置 JDBC 提供程序
为了在应用程序与关系数据库之间创建连接,应用程序服务器使用由 Java 数据库连接 (JDBC) 提供程序封装的驱动程序实现类。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用管理控制台来配置数据源
应用程序组件使用数据源来访问关系数据库的连接实例。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
AdminTask 对象的 ResourceManagement 命令组
要通过 wsadmin 工具配置资源提供程序,可以使用 Jython 或 Jacl 脚本语言来实现。ResourceManagement 组中的命令和参数可用来为资源提供程序定义和显示属性。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 JMX API 来创建和配置 JDBC 提供程序和数据源
如果应用程序需要使用 Java 数据库连接 (JDBC) API 来访问关系数据库,那么您可以单独使用 Java 管理扩展 (JMX) API 来创建必需的 JDBC 提供程序和数据源对象。或者,可以将 JMX API 与 wsadmin 脚本编制工具配合使用。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
访问现有 Java EE 数据源资源
您用于访问 WebSphere Application Server 受管数据源(在脚本编制或集成解决方案控制台中定义)的同一 DataSource MBean 和 JDBCProvider MBean 编程模型可用于访问 Java™ Platform Enterprise Edition (Java EE) 数据源资源,该资源是在应用程序中使用 DataSourceDefinition 注释或部署描述符的 <data-source> 元素定义的。此功能保持与现有脚本的兼容性,以简化资源的管理。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 DB2 通用 JDBC 驱动程序来访问 DB2 for z/OS
z/OS 操作系统要求配置 DB2 通用 JDBC 驱动程序和数据库以确保互操作性。在 WebSphere Application Server 中,配置 Java 数据库连接 (JDBC) 提供程序对象和数据源对象以实现应用程序的驱动程序功能。
创建使用针对 OCI 的 Oracle JDBC 驱动程序的数据源
可将 Oracle JDBC for OCI 驱动程序与 V7.0 和更高版本的应用程序服务器配合使用。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
对应用程序服务器配置 Oracle Real Application Cluster (RAC)
Oracle Real Application Cluster (RAC) 是一种“随处共享”数据库体系结构,在此体系结构中,两个或两个以上 Oracle RAC 节点集群到一起并共享同一存储器。RAC 节点通过高速互连来连接到一起,从而允许在 Oracle 节点之间进行高速通信。这些节点可以在启动期间交换各种类别的数据块所有权信息、锁定信息以及交换事务信息和数据等。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
为使用 DB2 数据库的应用程序配置客户机重新路由
客户机重新路由功能使您能够针对 DB2 通用数据库配置客户机应用程序以便在通信中断后进行恢复,以使应用程序能够继续工作而中断时间最短。重新路由是持续操作支持的核心,但只有对客户机连接标识备用位置之后,才有可能进行重新路由。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
为使用 DB2 数据库的应用程序配置客户机亲缘关系
客户机亲缘关系功能可替代允许数据源在连接失败时使用其他服务器的客户机自动重新路由。在此仅客户机方法中,客户机确定故障转移期间备用服务器的运行顺序。有关客户机亲缘关系的更多信息,请参阅 DB2 信息中心中的“DB2 Database for Linux, UNIX, and Windows 的客户机亲缘关系”主题。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
验证数据源连接
通过验证配置参数可以很容易地修改许多连接问题。必须完成一些步骤才能启用成功连接。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
测试连接服务
WebSphere Application Server 提供了用于验证数据源配置的测试连接服务。testConnection 操作实例化数据源配置、获取连接,然后立即关闭连接。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
测试与管理控制台的连接
您定义和保存了数据源之后,可以单击测试连接按钮来确保此数据源定义中的参数是正确的。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 wsadmin 测试连接
wsadmin 脚本编制工具的 AdminControl 对象具有一个 testConnection 操作,该操作用于测试数据源对象的配置属性。![[IBM i]](../images/iseries.gif)
配置数据源 JDBC 提供程序以在 Java SE 环境中使用 pureQuery
使用此任务配置应用程序数据源 Java 数据库连接 (JDBC) 提供程序以使用 pureQuery 访问 Java Standard Edition (Java SE) 环境中的 DB2。此配置适用于 Java™ 持久性 API (JPA) 2.0 规范提供程序 WSJPA。![[IBM i]](../images/iseries.gif)
配置数据源 JDBC 提供程序以在 Java SE 环境中使用 pureQuery
使用此任务配置应用程序数据源 Java 数据库连接 (JDBC) 提供程序以使用 pureQuery 访问 Java Standard Edition (Java SE) 环境中的 DB2。此配置适用于 Java™ 持久性 API (JPA) 2.0 规范提供程序 WSJPA。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
按供应商排序的数据源最小必需设置
根据 Java 数据库连接 (JDBC) 驱动程序实现的数据库供应商要求,这些属性各不相同。您必须对配置的每个数据源设置适当的属性。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Apache Derby 的数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Apache Derby 数据源。
使用 AIX、HP-UX、Linux、Solaris 或 Windows 上的应用程序服务器的 DB2 的数据源最小需求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置适用于连接到运行在 AIX、HP-UX、Linux、Solaris 或 Windows 系统上的应用程序服务器的 DB2 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
适用于 IBM i 的DB2 通用数据库数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 DB2 UDB 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Informix 的数据源最小要求设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Informix 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Microsoft SQL Server 的数据源最小要求设置
根据 Java 数据库连接 (JDBC) 驱动程序实现的数据库供应商要求,这些属性各不相同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Microsoft SQL Server 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Oracle 的数据源最小必需设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Oracle 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Sybase 的数据源最小必需设置
这些属性随数据库供应商对 JDBC 驱动程序实现的要求不同而有所不同。您必须对配置的每个数据源设置适当的属性。这些设置用于 Sybase 数据源。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用管理控制台来配置 JDBC 提供程序
为了在应用程序与关系数据库之间创建连接,应用程序服务器使用由 Java 数据库连接 (JDBC) 提供程序封装的驱动程序实现类。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用管理控制台来配置数据源
应用程序组件使用数据源来访问关系数据库的连接实例。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
AdminTask 对象的 ResourceManagement 命令组
要通过 wsadmin 工具配置资源提供程序,可以使用 Jython 或 Jacl 脚本语言来实现。ResourceManagement 组中的命令和参数可用来为资源提供程序定义和显示属性。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 JMX API 来创建和配置 JDBC 提供程序和数据源
如果应用程序需要使用 Java 数据库连接 (JDBC) API 来访问关系数据库,那么您可以单独使用 Java 管理扩展 (JMX) API 来创建必需的 JDBC 提供程序和数据源对象。或者,可以将 JMX API 与 wsadmin 脚本编制工具配合使用。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
访问现有 Java EE 数据源资源
您用于访问 WebSphere Application Server 受管数据源(在脚本编制或集成解决方案控制台中定义)的同一 DataSource MBean 和 JDBCProvider MBean 编程模型可用于访问 Java™ Platform Enterprise Edition (Java EE) 数据源资源,该资源是在应用程序中使用 DataSourceDefinition 注释或部署描述符的 <data-source> 元素定义的。此功能保持与现有脚本的兼容性,以简化资源的管理。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 DB2 通用 JDBC 驱动程序来访问 DB2 for z/OS
z/OS 操作系统要求配置 DB2 通用 JDBC 驱动程序和数据库以确保互操作性。在 WebSphere Application Server 中,配置 Java 数据库连接 (JDBC) 提供程序对象和数据源对象以实现应用程序的驱动程序功能。
创建使用针对 OCI 的 Oracle JDBC 驱动程序的数据源
可将 Oracle JDBC for OCI 驱动程序与 V7.0 和更高版本的应用程序服务器配合使用。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
对应用程序服务器配置 Oracle Real Application Cluster (RAC)
Oracle Real Application Cluster (RAC) 是一种“随处共享”数据库体系结构,在此体系结构中,两个或两个以上 Oracle RAC 节点集群到一起并共享同一存储器。RAC 节点通过高速互连来连接到一起,从而允许在 Oracle 节点之间进行高速通信。这些节点可以在启动期间交换各种类别的数据块所有权信息、锁定信息以及交换事务信息和数据等。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
为使用 DB2 数据库的应用程序配置客户机重新路由
客户机重新路由功能使您能够针对 DB2 通用数据库配置客户机应用程序以便在通信中断后进行恢复,以使应用程序能够继续工作而中断时间最短。重新路由是持续操作支持的核心,但只有对客户机连接标识备用位置之后,才有可能进行重新路由。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
为使用 DB2 数据库的应用程序配置客户机亲缘关系
客户机亲缘关系功能可替代允许数据源在连接失败时使用其他服务器的客户机自动重新路由。在此仅客户机方法中,客户机确定故障转移期间备用服务器的运行顺序。有关客户机亲缘关系的更多信息,请参阅 DB2 信息中心中的“DB2 Database for Linux, UNIX, and Windows 的客户机亲缘关系”主题。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
验证数据源连接
通过验证配置参数可以很容易地修改许多连接问题。必须完成一些步骤才能启用成功连接。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
测试连接服务
WebSphere Application Server 提供了用于验证数据源配置的测试连接服务。testConnection 操作实例化数据源配置、获取连接,然后立即关闭连接。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
测试与管理控制台的连接
您定义和保存了数据源之后,可以单击测试连接按钮来确保此数据源定义中的参数是正确的。![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用 wsadmin 测试连接
wsadmin 脚本编制工具的 AdminControl 对象具有一个 testConnection 操作,该操作用于测试数据源对象的配置属性。
任务主题
最近一次更新时间: last_datehttp://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tdat_tccrtprovds
文件名:tdat_tccrtprovds.html