中文文档

将事件发布至PostgreSQL

MinIO 支持将 桶通知 事件发布到 PostgreSQL。 MinIO 仅 支持 PostgreSQL 9.5 及更高版本。

将 PostgreSQL 端点添加到 MinIO 部署

以下步骤将在MinIO部署中添加一个新的PostgreSQL服务端点, 以支持 桶通知 。

先决条件

PostgreSQL 9.5 及更高版本

MinIO 依赖于 PostgreSQL 9.5 引入的功能。

MinIO mc 命令行工具

此过程使用 mc 命令行工具执行某些操作。 请参阅 mc 的 快速入门 以获取安装说明。

1) 将 PostgreSQL 端点添加到 MinIO

您可以通过设置环境变量 或 运行时配置设置来 配置新的PostgreSQL服务端点。

MinIO 支持指定 PostgreSQL 服务端点和关联的 配置设置使用 环境变量. 当您设置环境变量后,minio server 进程将在下一次启动时 应用这些设置。

以下示例代码设置 所有 环境变量 与配置 PostgreSQL 服务端点相关。 最低 必需的 变量是:

  • MINIO_NOTIFY_POSTGRES_CONNECTION_STRING

  • MINIO_NOTIFY_POSTGRES_TABLE

  • MINIO_NOTIFY_POSTGRES_FORMAT

   export MINIO_NOTIFY_POSTGRES_ENABLE_<IDENTIFIER>="on"
   export MINIO_NOTIFY_POSTGRES_CONNECTION_STRING_<IDENTIFIER>="host=postgresql-endpoint.example.net port=4222"
   export MINIO_NOTIFY_POSTGRES_TABLE_<IDENTIFIER>="minioevents"
   export MINIO_NOTIFY_POSTGRES_FORMAT_<IDENTIFIER>="namespace|access"
   export MINIO_NOTIFY_POSTGRES_MAX_OPEN_CONNECTIONS_<IDENTIFIER>="2"
   export MINIO_NOTIFY_POSTGRES_QUEUE_DIR_<IDENTIFIER>="/opt/minio/events"
   export MINIO_NOTIFY_POSTGRES_QUEUE_LIMIT_<IDENTIFIER>="100000"
   export MINIO_NOTIFY_POSTGRES_COMMENT_<IDENTIFIER>="PostgreSQL Notification Event Logging for MinIO"
  • 将 <IDENTIFIER> 替换为 PostgreSQL 服务端点的唯一 描述性字符串。 对于与新的目标服务端点相关的所有环境变量, 使用相同的 <IDENTIFIER> 值。 以下示例假设标识符为 PRIMARY 。

    如果指定的 <IDENTIFIER> 与 MinIO 部署中现有的 PostgreSQL 服务端点匹配,新设置将 覆盖 该端点的任何现有设置。 使用 mc admin config get notify_postgres 来查看 MinIO 部署上当前配置的 PostgreSQL 端点。

  • 将 <ENDPOINT> 替换为 PostgreSQL 服务端点 的 PostgreSQL Connection String。 MinIO 支持使用 key=value 格式用于连接 字符串。 例如:

    host=https://postgresql.example.com port=5432 ...

    有关支持 PostgreSQL 连接字符串参数的更完整文档, 请参阅 PostgreSQL Connection String。

请参阅 PostgreSQL Service for Bucket Notifications 以获取有关每个环境变量的完整文档。

MinIO 支持在运行中的 minio server 进程上添加 或更新 PostgreSQL 端点,使用 mc admin config set 命令 和 notify_postgres 配置键。 您必须重新启动 minio server 进程以应用 任何新的或更新的配置设置。

以下示例代码设置了与配置 PostgreSQL 服务端点相关的 所有 设置。 最小 必需 设置包括:

  • notify_postgres connection_string

  • notify_postgres table

  • notify_postgres format

mc admin config set ALIAS/ notify_postgres:IDENTIFIER \
   connection_string="ENDPOINT" \
   table="<string>" \
   format="<string>" \
   max_open_connections="<string>" \
   queue_dir="<string>" \
   queue_limit="<string>" \
   comment="<string>"
  • 将 IDENTIFIER 替换为唯一的描述性字符串 PostgreSQL 服务端点。此过程中的以下示例 假设标识符为 PRIMARY 。

    如果指定的 IDENTIFIER 匹配 MinIO 部署上现有的 PostgreSQL 服务端点,则新设置将 覆盖 该端点上现有的任何设置。 使用 mc admin config get notify_postgres r来查看 MinIO 部署上当前配置的 PostgreSQL 端点。

  • 将 <ENDPOINT> 替换为 PostgreSQL 服务端点的 PostgreSQL URI 连接字符串。 MinIO 支持 key=value 格式的 PostgreSQL 连接字符串。 例如:

    host=https://postgresql.example.com port=5432 ...

    有关支持 PostgreSQL 连接字符串参数的更完整文档, 请参阅 PostgreSQL Connection String。

请参阅 PostgreSQL 存储桶通知配置设置 , 以获取每个设置的完整文档。

2) 重新启动MinIO部署。

您必须重新启动MinIO部署以应用配置更改。 使用 mc admin service restart 命令来重新启动部署。

mc admin service restart ALIAS

将 ALIAS 替换为要重新启动的部署的 别名。

当启动 minio server 进程时,它会为每个配置的 PostgreSQL 目标打印一行 类似以下内容的信息:

SQS ARNs: arn:minio:sqs::primary:postgresql

在配置带有关联 PostgreSQL 部署作为目标的存储桶通知时, 您必须指定 ARN 资源。

Identifying the ARN for your bucket notifications

在创建端点之前,您定义了 <IDENTIFIER> 以便为您的存储桶通知分配目标ARN。 以下是返回部署上配置的ARNs的步骤: 识别之前创建的ARN,请查找您指定的 <IDENTIFIER> 。

查看 JSON 输出

  1. 复制并运行以下命令,将 ALIAS 替换为部署的 别名。

    mc admin info --json ALIAS
    
  2. 在JSON输出中,查找键 info.sqsARN 。

    您需要的ARN是匹配您指定的 <IDENTIFIER> 的该键的值。

    例如, arn:minio:sqs::primary:postgresql.

使用 jq 解析 JSON 中的值

  1. Install jq

  2. 复制并运行以下命令,将 ALIAS 替换为部署的 别名。

    mc admin info --json ALIAS | jq  .info.sqsARN
    

    这将返回用于通知的ARN,例如 arn:minio:sqs::primary:postgresql。

3) 使用 PostgreSQL 端点作为目标配置存储桶通知

使用 mc event add 命令添加一个新的桶通知事件, 以配置的 PostgreSQL 服务作为目标的事件:

mc event add ALIAS/BUCKET arn:minio:sqs::primary:postgresql \
  --event EVENTS
  • 将 ALIAS 替换为MinIO部署的 别名。

  • Replace BUCKET with the name of the bucket in which to configure the ßevent.

  • 将 EVENTS 替换为 MinIO 触发通知的 事件 的逗号分隔列表。

使用 mc event ls 命令查看给定通知目标的 所有配置桶事件:

mc event ls ALIAS/BUCKET arn:minio:sqs::primary:postgresql

4) 验证配置的事件

对已配置新事件的存储桶执行一个操作,并检查 PostgreSQL 服务是否收到了通知数据。 所需操作取决于在配置存储桶通知时指定的 事件。

例如,如果桶通知配置包括 s3:ObjectCreated:Put 事件, 您可以使用 mc cp 命令在 桶中创建一个新对象并 触发通知。

mc cp ~/data/new-object.txt ALIAS/BUCKET

更新 MinIO 部署中的 PostgreSQL 端点

以下过程更新现有 PostgreSQL 服务端点 在 MinIO 中支持 bucket notifications 部署。

先决条件

PostgreSQL 9.5 及更高版本

MinIO 依赖于 PostgreSQL 9.5 引入的功能。

MinIO mc 命令行工具

此过程使用 mc 命令行工具执行某些操作。 请参阅 mc 的 快速入门 以获取安装说明。

1) 列出部署中配置的 PostgreSQL 端点

使用 mc admin config get 命令来列出当前配置的 PostgreSQL 服务端点:

mc admin config get ALIAS/ notify_postgres

将 ALIAS 替换为 MinIO 部署的 别名。

命令的输出类似于以下内容:

notify_postgres:primary queue_dir="" connection_string="postgresql://" queue_limit="0"  table="" format="namespace"
notify_postgres:secondary queue_dir="" connection_string="" queue_limit="0"  table="" format="namespace"

notify_postgres 是一个顶级配置键,用于 minio-server-config-bucket-notification-postgresql. The connection_string 键指定了给定 notify_postgres 键的 PostgreSQL 服务端点。 notify_postgres:<IDENTIFIER> 后缀描述了该 PostgreSQL 服务端点的唯一 标识符。

请注意,下一步要更新的 PostgreSQL 服务端点的 标识符。

2) 更新 PostgreSQL 端点

使用 :mc-cmd:`mc admin config set`命令来设置 PostgreSQL 服务端点:

mc admin config set ALIAS/ notify_postgres:IDENTIFIER \
   connection_string="ENDPOINT" \
   table="<string>" \
   format="<string>" \
   max_open_connections="<string>" \
   queue_dir="<string>" \
   queue_limit="<string>" \
   comment="<string>"

对于 PostgreSQL 服务端点,以下配置设置是 最小 必需的:

  • notify_postgres connection_string

  • notify_postgres table

  • notify_postgres format

所有其他配置设置都是 可选的。 请参阅 minio-server-config-bucket-notification-postgresql 以获取完整的 PostgreSQL 配置设置列表。

3) 重新启动MinIO部署。

您必须重新启动MinIO部署以应用配置更改。 使用 mc admin service restart 命令来重新启动部署。

mc admin service restart ALIAS

将 ALIAS 替换为要重新启动的部署的 别名。

当启动 minio server 进程时,对于每个配置的 PostgreSQL 目标, 它会在控制台打印一行类似以下内容的信息:

SQS ARNs: arn:minio:sqs::primary:postgresql

4) 验证更改

对具有事件配置的存储桶执行一个操作,并使用更新后的 PostgreSQL 服务端点 检查 PostgreSQL 服务中的通知数据。 The 所需操作取决于在配置存储桶通知时指定的 事件。

例如,如果桶通知配置包括 s3:ObjectCreated:Put 事件, 您可以使用 mc cp 命令在 桶中创建一个新对象并 触发通知。

mc cp ~/data/new-object.txt ALIAS/BUCKET
Join Slack 商业支持购买咨询