这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

12 Oracle 数据库配置

概述

本节包含有关创建 Oracle 数据库以及配置数据库与 Zabbix server、proxy 和 agent 之间的连接的说明。

数据库创建

假设有一个密码为 passwordzabbix 数据库用户,并且有权在 Oracle 数据库上的 ORCL 服务中创建数据库对象。Zabbix 需要一个 Unicode 数据库字符集和一个 UTF8字符集。检查当前的设置:

sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET';

现在准备数据库:

shell> cd /path/to/zabbix-sources/database/oracle
       shell> sqlplus zabbix/password@oracle_host/ORCL
       sqlplus> @schema.sql
       # stop here if you are creating database for Zabbix proxy
       sqlplus> @images.sql
       sqlplus> @data.sql

请设置初始化参数以达到最佳的性能 CURSOR_SHARING=FORCE

连接设置

Zabbix支持两种类型的连接标识符(连接方法):

  • Easy Connect
  • Net Service Name

Zabbix server 和 Zabbix proxy的连接配置参数可以在配置文件中设置。server和proxy的重要参数是 DBHost, DBUser, DBNameDBPassword。相同的参数对于前端很重要: $DB["SERVER"], $DB["PORT"], $DB["DATABASE"], $DB["USER"], $DB["PASSWORD"].

Zabbix 使用以下连接字符串语法:

{DBUser/DBPassword[@<connect_identifier>]} 

<connect_identifier> 可以以以下形式指定 "Net Service Name" 或 "Easy Connect".

@[[//]Host[:Port]/<service_name> | <net_service_name>]

Easy Connect

Easy Connect 使用以下参数连接到数据库:

  • Host - 数据库服务器的主机名或 IP 地址(配置文件中的 DBHost 参数)。
  • Port - 数据库服务器上的监听端口(配置文件中的 DBPort 参数;如果未设置,将使用默认的 1521 端口)
  • <service_name> - 要访问数据库的服务名称(配置文件中的 DBName 参数)。

例: 在server 或 proxy 配置文件中设置的数据库参数 (zabbix_server.conf and zabbix_proxy.conf):

DBHost=localhost
       DBPort=1521
       DBUser=myusername
       DBName=ORCL
       DBPassword=mypassword

Zabbix 用于建立连接的字符串:

DBUser/DBPassword@DBHost:DBPort/DBName

在 Zabbix 前端安装过程中,在安装向导的Configure DB connection步骤中设置相应的参数:

  • Database host: localhost
  • Database port: 1521
  • Database name: ORCL
  • User: myusername
  • Password: mypassword

或者,可以在前端配置文件 (zabbix.conf.php) 中设置这些参数:

$DB["TYPE"]                     = 'ORACLE';
       $DB["SERVER"]                   = 'localhost';
       $DB["PORT"]             = '1521';
       $DB["DATABASE"]                 = 'ORCL';
       $DB["USER"]                     = 'myusername';
       $DB["PASSWORD"]                 = 'mypassword';

网络服务名称

从Zabbix 5.4.0开始,可以使用net service name连接到Oracle。

<net_service_name> 是解析为连接描述符服务的简单名称。

为了使用服务名称创建连接,必须在位于数据库服务器和客户端系统上的 tnsnames.ora 文件中定义此服务名称。确保连接成功的最简单方法是在TNS_ADMIN环境变量中定义 oftnsnames.ora 文件的位置。tnsnames.ora 文件的默认位置为:

$ORACLE_HOME/network/admin/

一个简单的 tnsnames.ora 文件示例:

ORCL =
         (DESCRIPTION =
           (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
           (CONNECT_DATA =
             (SERVER = DEDICATED)
             (SERVICE_NAME = ORCL)
           )
         )

若要设置"Net Service Name"连接方法,请使用下列选项:

  • 将 DBHost 设置为空,并设置 DBName
DBHost=
       DBName=ORCL
  • 配置两个参数且值为空:
DBHost=
       DBName=

在第二种情况下,必须设置TWO_TAKS环境变量。它指定默认的远程 Oracle 服务(服务名称)。定义此变量后,连接器将使用接受连接请求的 Oracle 监听连接到指定的数据库。此变量仅在 Linux 和 UNIX 上使用。 Microsoft Windows 使用 LOCAL 环境变量

例:

使用设置为 ORCL 和默认端口的 Net Service Name 连接到数据库。在 server 或 proxy 配置文件(zabbix_server.conf 和 zabbix_proxy.conf) 中设置的数据库参数:

DBHost=
       #DBPort=
       DBUser=myusername
       DBName=ORCL
       DBPassword=mypassword

在 Zabbix 前端安装过程中,在安装向导的Configure DB connection步骤中设置相应的参数:

  • Database host:
  • Database port: 0
  • Database name: ORCL
  • User: myusername
  • Password: mypassword

或者,可以在前端配置文件中设置这些参数 (zabbix.conf.php):

$DB["TYPE"]                     = 'ORACLE';
       $DB["SERVER"]                   = '';
       $DB["PORT"]           = '0';
       $DB["DATABASE"]                 = 'ORCL';
       $DB["USER"]                     = 'myusername';
       $DB["PASSWORD"]                 = 'mypassword';

Zabbix 用于建立连接的字符串:

DBUser/DBPassword@ORCL

Known issues

To improve performance, you can convert the field types from nclob to nvarchar2, see known issues.