MySQL 通知设置
This page documents settings for configuring a MYSQL service as a target for存储桶通知.发布事件到 MySQL有关使用这些设置的教程。
您可以通过定义以下内容来建立或修改设置：
an 环境变量在启动或重启 MinIO 服务器之前，请在主机系统上设置此环境变量。 有关如何定义环境变量，请参阅操作系统的文档。
a 配置设置使用
mc admin config set.
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
某些设置只有环境变量或配置设置，但没有两者都提供。
重要
每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前，先在较低环境（如开发环境或测试环境）中测试配置变更。
多个 MYSQL 目标
您可以通过附加唯一标识符来指定多个 MySQL 服务端点_ID将每组相关的 MySQL 设置映射到顶级键。
示例
以下命令设置两个不同的 MySQL 服务端点作为PRIMARY和SECONDARY分别：
export MINIO_NOTIFY_MYSQL_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_MYSQL_DSN_STRING_PRIMARY="username:password@tcp(mysql.example.com:3306)/miniodb"
export MINIO_NOTIFY_MYSQL_TABLE_PRIMARY="minioevents"
export MINIO_NOTIFY_MYSQL_FORMAT_PRIMARY="namespace"
export MINIO_NOTIFY_MYSQL_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_MYSQL_DSN_STRING_SECONDARY="username:password@tcp(mysql.example.com:3306)/miniodb"
export MINIO_NOTIFY_MYSQL_TABLE_SECONDARY="minioevents"
export MINIO_NOTIFY_MYSQL_FORMAT_SECONDARY="namespace"
使用这些设置，MINIO_NOTIFY_MYSQL_ENABLE_PRIMARY表示环境变量与ID为的MySQL服务端点相关联PRIMARY.
mc admin config set notify_mysql:primary \
dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
table="minioevents" \
format="namespace" \
[ARGUMENT=VALUE ...]
mc admin config set notify_mysql:secondary \
dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
table="minioevents" \
format="namespace" \
[ARGUMENT=VALUE ...]
设置
启用
必需
指定on以启用将存储桶通知发布到 MySQL 服务端点的功能。
默认值为off.
如果设置为，需要指定以下额外的环境变量on:
用于定义 MySQL 服务端点的顶级配置键MinIO 存储桶通知.
使用mc admin config set设置或更新 MySQL 服务端点。
以下参数是必需对于每个目标：
将其他可选参数指定为空格分隔的" ")-分隔的列表。
mc admin config set notify_mysql \
dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
table="minioevents" \
format="namespace" \
[ARGUMENT="VALUE"] ... \
数据源名称 (DSN) 字符串
必需
指定 MySQL 服务端点的数据源名称（DSN）。MinIO 期望以下格式：
<user>:<password>@tcp(<host>:<port>)/<database>
例如：
"username:password@tcp(mysql.example.com:3306)/miniodb"
Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态（是否可解析和可达）。 即使现有通知目标处于离线状态，MinIO 也不再阻止添加新的通知目标。
Table
必需
指定 MinIO 发布事件通知的 MySQL 表名称。
格式
必需
指定写入 MySQL 服务端点的事件数据格式。 MinIO 支持以下值：
namespace对于每个存储桶事件，MinIO 会创建一个 JSON 文档，将事件中的存储桶和对象名称作为文档 ID，并将实际事件作为文档正文的一部分。 对该对象的后续更新会修改该对象的现有表条目。 同样，删除对象也会删除相应的表条目。
access对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并使用 MySQL 生成的随机 ID 将其附加到表中。 对对象的其他更新会产生新的索引条目，而现有条目保持不变。
最大打开连接数
可选
指定到 MySQL 数据库的最大打开连接数。
默认值为2.
队列目录
可选
指定目录路径以启用 MinIO 的持久化事件存储，用于存放未送达的消息，例如/opt/minio/events.
MinIO在MySQL服务器/代理离线时将未送达的事件存储在指定的存储中，并在连接恢复时重放存储的事件。
队列限制
可选
指定未送达消息的最大限制。默认为100000.
评论
可选
指定要与 MySQL 配置关联的注释。
