IBM Performance Management

JDBC 配置

在代理程序中定义 JDBC 数据源时，将为您创建部分配置属性。

如果在代理程序中定义了 JDBC 数据源，那么该代理程序必须使用 Java™ 来连接 JDBC 数据库服务器。 Java 配置属性将自动添加到代理程序中。 下列 Java 配置属性特定于代理程序运行时配置：
  • Java 主目录：指向 Java 安装目录的标准路径
  • JVM 自变量：使用此参数为 Java 虚拟机指定一个可选自变量列表。
  • 跟踪级别：：此参数定义要写入 Java 跟踪日志文件的信息量。 缺省设置为只将错误数据写入日志文件。
注： Agent Builder 不需要这些 Java 属性，因为它使用自己的 JVM 以及日志记录，这是通过 JLog 插件配置的。
如果在代理程序中定义 JDBC 数据源，那么将向该代理程序中自动添加以下必需的公共配置字段：
  • JDBC database type：要连接的数据库的类型，即 IBM® DB2®、Microsoft SQL Server 或 Oracle Database Server。
  • JDBC user name：用于向数据库服务器认证的用户名。
  • JDBC password：用于向数据库服务器认证的密码。
  • Base paths：要在其中搜索 Class Path 字段所指定 JAP 文件的目录列表，或者为 JAR directories 字段所指定的非标准目录的列表。 目录名称在 Windows 系统上以分号 (;) 分隔，在 UNIX 系统上以分号 (;) 或冒号 (:) 分隔。
  • Class path：代理程序要搜索的显式指定 JAR 文件。 在找到 JAR 文件之前，所有具有非标准名称的文件都将追加到每个“基本路径”中。
  • JAR directories：要在其中搜索 JAR 文件的目录的列表。 目录名称在 Windows 系统上以分号 (;) 分隔，在 UNIX 系统上以分号 (;) 或冒号 (:) 分隔。 您不必显式指示这些目录中的 JAR 文件；这些 JAR 文件会因为它们在其中一个目录中而被找到。 但不会搜索这些目录的子目录。 在找到目录之前，所有具有非标准名称的目录都将追加到每个“基本路径”中。
运行时配置还需要您指定一些其他详细信息才能连接到数据库。 可以选择如何指定其余配置项，指定为 JDBC URL 或基本配置属性（缺省设置）：
  • URL 配置选项
    • JDBC 连接 URL：特定于供应商的连接 URL，提供有关数据库所在的主机以及连接到的端口号的详细信息。 URL 格式通常如下所示： 
      jdbc:identifier://server:port/database
      请参阅 JDBC 驱动程序供应商文档以了解不同的 URL 格式。
  • JDBC 基本属性选项（缺省设置）
    • JDBC 服务器名称：正在运行数据库服务器的主机名。
    • JDBC 数据库名称：建立了连接的主机上的数据库的名称。
    • JDBC 端口号：数据库服务器正在侦听的端口号。
注： 借助 JDBC 数据提供程序，可以使用子节点在同一个代理程序中监视多种数据库类型。 要使用该方法进行监视，必须仔细定义“子节点配置覆盖”。 如果监视多个数据库类型，以下配置设置很可能不同：
  • JDBC 数据库类型
  • JDBC 用户名
  • JDBC 密码
如果您正在使用基本配置选项，那么还必须在“子节点配置覆盖”页面上针对下列属性定义覆盖项：
  • JDBC 服务器名称
  • JDBC 端口号
  • JDBC 数据库名称
要为子节点定义配置覆盖项，请参阅使用子节点，以获取有关访问“子节点配置覆盖”页面的更多详细信息。 当您在运行时配置代理程序时，必须针对创建的每个新子节点实例配置所有这些属性。

除了配置覆盖项，您的代理程序还必须指向各个数据库类型的 JDBC 驱动程序，您将在子节点中连接到该驱动程序。 JAR 目录参数是指向 JDBC 驱动程序最方便的方式。 使用分号来分隔每个目录，以列出包含 JDBC 驱动程序的目录。 例如，如果要使用代理程序连接到 DB2 和 Oracle 数据库，您必须指定类似于以下示例的 JAR 目录值：C:\Program Files\IBM\SQLLIB\java;C:\oracle\jdbc。