1 数据库创建

概述

在安装 Zabbix server 或 proxy 期间，必须创建一个 Zabbix 数据库。

本节提供有关创建 Zabbix 数据库的说明。对于每个受支持的数据库，均有单独的一组说明。

通过创建具有最小权限的数据库角色/用户来提高数据库安全性，请参阅每个受支持数据库的最佳实践：

有关配置安全的 TLS 连接，请参阅 Secure connection to the database。

UTF-8 是 Zabbix 唯一支持的编码方式。已知其运行没有任何安全漏洞。 用户应注意，如果使用其他某些编码方式，则可能存在已知的安全 问题。 有关切换到 UTF-8，请参阅 Repairing Zabbix database character set and collation。 另请参阅 使用utf8mb4排序规则过滤的限制。

如果从Zabbix Git repository安装，则在继续下一步之前需要run以下命令：

make dbschema

MySQL/MariaDB

支持字符集 utf8（即 utf8mb3）和 utf8mb4（分别使用 utf8_bin 和 utf8mb4_bin 排序规则），以便 Zabbix 服务器/proxy 能够与 MySQL 数据库正常工作。 建议新安装使用 utf8mb4。

在导入 schema 时需要创建确定性触发器。 在 MySQL 和 MariaDB 中，如果启用了二进制日志、没有超级用户权限，并且 MySQL 配置文件中未设置 log_bin_trust_function_creators = 1，则需要设置 GLOBAL log_bin_trust_function_creators = 1。

如果您是从 packages 或 containers 安装 Zabbix，请参阅相应说明。

如果您是从源码安装 Zabbix：

  • 创建并配置数据库和用户。
mysql -uroot -p<password>

mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin;
mysql> create user 'zabbix'@'localhost' identified by '<password>';
mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost';
mysql> SET GLOBAL log_bin_trust_function_creators = 1;
mysql> quit;
  • 将数据导入数据库，并将 utf8mb4 字符集设为默认值（假设您位于 Zabbix 源码根目录）。 对于 Zabbix proxy 数据库，只应导入 schema.sql（不需要 images.sql 或 data.sql）。
cd database/mysql
mysql -uzabbix -p<password> zabbix < schema.sql
# 如果您正在为 Zabbix proxy 创建数据库，请在此处停止
mysql -uzabbix -p<password> zabbix < images.sql
mysql -uzabbix -p<password> --default-character-set=utf8mb4 zabbix < data.sql

在 schema 成功导入后，可以禁用 log_bin_trust_function_creators：

mysql -uroot -p<password>

mysql> SET GLOBAL log_bin_trust_function_creators = 0;
mysql> quit;

PostgreSQL

您需要拥有具有创建数据库对象权限的数据库用户。

如果您是从 packages 或 containers 安装 Zabbix，请参阅相应的说明。

如果您是从源代码安装 Zabbix：

  • 创建一个数据库用户。

下面的 shell 命令将创建用户 zabbix。 在提示时指定密码，并重复输入该密码（注意，系统可能会先要求您输入 sudo 密码）：

sudo -u postgres createuser --pwprompt zabbix
  • 创建一个数据库。

下面的 shell 命令将使用之前创建的用户作为所有者（-O zabbix），创建数据库 zabbix（最后一个参数）。

sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix
  • 导入初始模式和数据（假设您位于 Zabbix 源代码根目录）。 对于 Zabbix proxy 数据库，只应导入 schema.sql（不需要 images.sql 或 data.sql）。
cd database/postgresql
cat schema.sql | sudo -u zabbix psql zabbix
# 如果您正在为 Zabbix proxy 创建数据库，请在此处停止
cat images.sql | sudo -u zabbix psql zabbix
cat data.sql | sudo -u zabbix psql zabbix

以上命令仅作为示例，在大多数 GNU/Linux 安装中都可以正常工作。 您可以根据系统/数据库的配置使用不同的命令，例如：

psql -U <username>

如果您在设置数据库时遇到任何问题，请咨询您的数据库管理员。

TimescaleDB

创建和配置 TimescaleDB 的说明请参见单独的章节。

Oracle

创建和配置 Oracle 数据库的说明请参见单独的章节。

SQLite

仅 Zabbix proxy 支持使用 SQLite！

如果数据库不存在，将会自动创建。

返回到安装部分。