使用管理控制台来配置数据源

应用程序组件使用数据源来访问关系数据库的连接实例。

准备工作

应用程序服务器支持数据源的两个不同版本。 请根据应用程序所基于的企业 bean 和 Servlet 规范级别来确定环境的数据源:
  • 数据源 (WebSphere® Application Server V 4) 用于 Enterprise JavaBeans (EJB) 1.0 规范和 Java™ Servlet 2.2 规范。
  • 最新标准版的数据源与实现了这些更高级发行版规范的应用程序配合使用。

有关此任务

创建数据源时,将其与配置为访问特定供应商数据库的 Java 数据库连接 (JDBC) 提供程序相关联。 应用程序服务器要求应用程序的这两个对象都调用该特定数据库并从该数据库中接收数据。 数据源提供了连接管理功能,该功能在物理上使应用程序与数据库之间的数据交换成为可能。
请记住: 必须重新启动服务器,新创建的数据源才能用于应用程序中的 Java 命名和目录接口 (JNDI)。

过程

  1. 打开管理控制台。
  2. 访问所需的控制台面板。
    请使用下列其中一条路径:
    • 单击 资源 > JDBC > 数据源
    • 单击 资源 > JDBC > 数据源 (WebSphere Application Server V 4)
    • 单击 资源 > JDBC > JDBC 提供者 > JDBC_provider > 数据源
    • 单击 资源 > JDBC > JDBC 提供者 > JDBC_provider > 数据源 (WebSphere Application Server 版本 4)
  3. 选择作用域,应用程序将可以在此作用域中使用该数据源。
    您可以选择单元、节点、集群或服务器。 有关更多信息,请参阅关于作用域设置的主题。
    版本 4: 从此时开始,创建 WebSphere Application Server 版本 4 数据源的步骤与创建最新标准版本的数据源的步骤不同。 要配置 V4 数据源:
    • 单击新建以转到用于定义必需属性的控制台面板。
    • 在此属性面板上,指定配置标题下面的字段的值。 应用程序服务器需要这些属性以实现 JDBC 驱动程序类。
    • 通过单击确定保存配置。 现在,您已完成主要的数据源配置任务。
    • 为使用 JDBC 驱动程序定义数据库供应商可能需要或作为选件提供的其他属性。 应用程序服务器称这些属性为定制属性,并要求对数据源设置这些属性。 首先,请单击管理控制台面板上当前显示的定制属性链接。 请参阅数据库文档以了解这些必需和可选属性。

      [z/OS]如果使用 DB2 Universal JDBC 驱动程序或 DB2 将 IBM® JCC 驱动程序用于 JDBC 提供程序,那么您还可以了解适用于您的 DB2® for z/OS® 版本的 Application Programming Guide and Reference for Java 中的可选数据源属性。

  4. 单击新建
    此操作将启动创建数据源向导并显示输入基本数据源信息面板。
    第一个字段是作用域字段,它是只读的。 此字段将显示先前选择的作用域。
  5. 数据源名称 字段中输入数据源名称。
    此名称标识数据源,仅供进行管理时使用。
  6. JNDI 名称 字段中输入 Java 命名和目录接口 (JNDI) 名称。
    应用程序服务器使用该 JNDI 名称将应用程序的资源引用与此数据源绑定。 在指定 JNDI 名称时,请遵循下列要求:
    • 不要跨不同资源类型(如数据源与 J2C 连接工厂或 JMS 连接工厂)指定重复的 JNDI 名称。
    • 不要对同一作用域中同一类型的多个资源指定重复的 JNDI 名称。
    有关 JNDI 的更多信息,请参阅关于命名的主题。
  7. 单击 下一步 以查看 选择 JDBC 提供程序 面板。
    如果尚未在当前作用域中配置任何 JDBC 提供程序,那么选择 JDBC 提供程序面板将被跳过。
  8. 选择现有的 JDBC 提供程序,或者创建新的提供程序。
    • 选择现有 JDBC 提供程序。
      1. 单击选择现有 JDBC 提供程序
      2. 从列表中选择 JDBC 驱动程序。
      3. 单击下一步。 现在,您将看到标题为输入特定于数据库的数据源属性的面板。
    • 创建新的 JDBC 提供程序。
      1. 单击创建新的 JDBC 提供程序
      2. 单击下一步以查看创建 JDBC 提供程序面板。
      3. 使用第一个下拉列表来选择需要创建的 JDBC 提供程序的数据库类型。
        "用户定义" 选项: 如果迂到以下任一场景,请针对数据库类型选择 用户定义 :
        • 您找不到所要使用的数据库类型。
        • 您在下一个步骤中无法选择所需的 JDBC 提供程序类型。
        “用户定义的”选项将使向导面板将提供程序类型显示为“用户定义的 JDBC 提供程序”,并将实现类型显示为“用户定义的”。 请参阅数据库文档,以了解用户定义的提供程序所需的 JDBC 驱动程序类文件、数据源属性以及其他内容。 您必须在接下来的两个向导面板上提供下列信息:
        • 数据库类路径信息
        • 特定于数据库的属性
      4. 如果第二个列表中显示了 JDBC 提供程序类型,请选择 JDBC 提供程序类型。 选择显示建议不要使用的以同时显示当前提供程序和建议不要使用的提供程序。 如果在这个扩充的列表中找不到要使用的提供程序,请从上一个数据库类型列表中选择用户定义的
      5. 从第三个列表中选择应用程序所需的实现类型。 如果应用程序不要求连接支持两阶段落实事务,请选择连接池数据源。 但是,如果应用程序要求连接支持两阶段落实事务,请选择 XA 数据源。 使用此数据源配置的应用程序将能够利用容器管理的事务恢复功能。

        选择实现类型后,向导将填写 JDBC 提供程序的名称和描述字段。 您可以对这些字段输入不同的值;他们仅用于管理。

      6. 在定义数据库类型、提供程序类型和实现类型之后,单击下一步。 现在,您将看到“输入数据库类路径信息”向导面板。
      7. 在“类路径”字段中,输入数据库 JDBC 驱动程序类文件的完整路径位置。 类路径信息将成为此面板上显示的 WebSphere 环境变量的值,格式为 ${DATABASE_JDBC_DRIVER_PATH}。 应用程序服务器使用该变量来定义 JDBC 提供程序;这样就不需要对各个应用程序指定静态 JDBC 类路径。 记住,如果没有为此变量提供完整并且正确的 JDBC 驱动程序类路径,那么数据源最终将失败。 如果此字段已显示了标准类路径,那么您可以通过填写此向导面板的其余内容并单击下一步来接受该变量定义。
      8. 使用本机库路径字段来指定 JDBC 驱动程序在应用程序服务器平台上正确工作所需的其他类文件。 请输入这些类文件的完整目录路径名。
      9. 单击下一步。 现在,您将看到输入特定于数据库的数据源属性面板。
  9. 完成 输入数据源的特定于数据库的属性 面板上的所有字段。
    • 如果容器管理的持久性 (CMP) 企业 bean 必须访问此数据源,请单击在容器管理的持久性 (CMP) 中使用此数据源
    • 任何其他特定于数据库类型的属性字段都将显示在此向导面板上。 有关这些属性设置的信息,请参阅“数据源必需设置(按供应商排序)”主题。 该文阐述了应用程序服务器中预定义的当前 JDBC 提供程序和建议不要使用的 JDBC 提供程序。
      用户定义的数据源: 此向导面板不显示与用户定义的 JDBC 提供程序相对应的数据源的其他属性字段。 但是,应用程序服务器通常可以从已安装的 JDBC 驱动程序类文件中抽取必需的数据源属性名。 应用程序服务器将他们定义为数据源定制属性,将其显示在定制属性控制台面板上并赋予其缺省值。 请参阅有关设置这些属性以及用户定义的数据源的任何其他需求的数据库文档。 创建数据源后,通过单击 数据源 > data_source > 定制属性浏览到管理控制台中相应的定制属性集合面板。 查看属性缺省值,必要时进行修改。

      仅当在 Deployment Manager 节点上安装特定于供应商的属性并正确配置其代表 WebSphere 变量时,应用程序服务器才能从驱动程序类文件中抽取这些属性。 否则,产品将显示参考消息(而不是错误消息),该消息指示您将必需属性手动定义为定制属性。

  10. 可选: 配置数据源的安全别名。
    可以不为任何认证方法进行选择,也可以选择下列其中一种类型:
    • 组件管理的认证别名 - 指定组件资源引用 res-auth 值为 Application 时使用的认证别名。 要定义新别名,请浏览至 相关项 > J2EE 连接器体系结构 (J2C) 认证 数据条目。 组件管理的别名表示应用程序中指定的标识与密码的组合,用于进行数据源认证。 因此,对数据源设置的别名必须与应用程序代码中的别名完全相同。
      1. 使用下拉列表来选择现有的组件管理的认证别名。
      2. 要创建新别名,请单击所提供的链接。 此操作将关闭数据源向导并使管理控制台显示 J2C 认证数据面板。 单击新建以定义新别名。 单击确定以保存设置并在 J2C 认证数据面板上查看新别名。 通过执行以下操作来重新启动数据源向导:回到数据源集合面板,选择适当的作用域,然后单击新建
      有关 Java 2 连接器 (J2C) 安全性的更多信息,请参阅有关管理 Java 2 连接器体系结构认证数据条目的主题。
    • 映射配置别名 - 仅当不存在组件资源引用的登录配置时,才使用此类型。 对组件资源引用指定登录配置以及相关属性是 res-auth 值设置为 Container 时定义认证策略的首选方法。 如果指定 DefaultPrincipalMapping 登录配置,那么相关联的属性将是 JAAS - J2C 认证数据条目别名。
    • 容器管理的认证别名 - 仅当不存在组件资源引用的登录配置时,才使用此类型。 当 res-auth 值设置为Container.
    注: 如果已在应用程序服务器中定义安全域,那么可以单击 浏览 ... 以选择要配置的资源的认证别名。 安全域支持在服务器之间隔离认证别名。 树形视图对于确定别名所属的安全域很有用,并且树形视图可以帮助您确定能够访问每个认证别名的服务器。 树形视图将针对每个资源进行调整,因此,当您无法使用域和别名时,就会将他们隐藏起来。
  11. 单击 下一步 以查看 " 摘要 " 面板,并查看数据源的任何信息。
    如果任何信息不正确,那么可以单击上一步返回并进行更正。
  12. 单击 完成 以保存配置并退出向导。
    现在,您将看到数据源面板,该面板将新配置与同一作用域中配置的其他数据源一起显示在一个表中。

下一步做什么?

  • 可以覆盖某些数据源属性的缺省值。
  • 可以配置数据库供应商可能需要或作为选项提供的其他属性。 请参阅数据库文档以了解有关这些设置的信息。
  • [z/OS]如果使用 DB2 Universal JDBC 驱动程序提供程序或 DB2 使用 IBM JCC 驱动程序, 了解适用于您的 DB2 for z/OS版本的 Application Programming Guide and Reference for Java 中的可选数据源属性。
  • 如果希望在 JDBC 数据源意外关闭时对所有未落实的工作执行特定的操作,那么可以将 commitOrRollbackOnCleanup 定制属性添加到 JDBC 数据源设置中。 可以为此属性指定的值包括 commitrollback

    如果您的 JDBC 数据源支持工作单元 (UOW) 检测,那么仅当您在某个离散工作单元内工作时,此属性才适用。 如果您的 JDBC 数据源不支持 UOW 检测,那么此属性始终适用。

    如果未将此属性添加到 JDBC 数据源设置中,那么将回滚所有已检测的隐式事务,并且您的应用程序必须处理所有未检测的隐式事务。

    要将此定制属性添加到 JDBC 数据源配置设置中:
    1. 在管理控制台中,单击 JDBC 提供者 > JDBC_provider > 数据源 > data_source > 定制属性 > 新建
    2. 名称 字段中输入 commitOrRollbackOnCleanup ,并在 字段中输入 commitrollback
    3. 保存更改。