人大金仓分析型数据库备份和恢复（七）

        配置数据库gpbackup和gprestore工具，以使用存储插件在备份或还原操作期间处理备份文件。 例如，在备份操作期间，插件会将备份文件发送到远程位置。 在还原操作期间，插件从远程位置检索文件。还可以使用数据库备份/还原存储插件API开发自定义存储插件。

S3存储插件

        S3存储插件应用程序允许在运行gpbackup和gprestore时使用Amazon Simple Storage Service（Amazon S3）位置来存储和检索备份。 Amazon S3提供安全，持久，高度可扩展的对象存储。S3存储插件还可以连接到Amazon S3兼容服务，例如Dell EMC Elastic Cloud Storage和Minio。要使用S3存储插件应用程序，请在配置文件中指定插件的位置以及S3登录和备份位置。 运行gpbackup或gprestore时，使用选项--plugin-config指定配置文件。如果使用gpbackup选项--plugin-config执行备份操作，则还必须在使用gprestore还原备份时指定--plugin-config选项。

S3配置文件

        S3存储插件配置文件使用YAML文档格式并实现自己的模式， 以指定数据库S3存储插件的位置，连接凭据以及S3位置和登录信息。配置文件必须是有效的YAML文档。 gpbackup和gprestore工具按顺序处理控制文件文档，并使用缩进（空格）来确定文档层次结构以及这些部分之间的关系。 使用空白区域非常重要。 不应仅将白色空间用于格式化目的，并且根本不应使用制表符。

        S3存储插件配置文件的结构：

executablepath: <absolute-path-to-gpbackup_s3_plugin>
options:
region: <aws-region>
endpoint: <S3-endpoint>
aws_access_key_id: <aws-user-id>
aws_secret_access_key: <aws-user-id-key>
bucket: <s3-bucket>
folder: <s3-location>
encryption: [on|off]

•  executablepath

需要。 插件可执行文件的绝对路径。 例如，数据库安装位置是$GPHOME/bin/gpbackup_s3_plugin。 该插件必须位于每个数据库主机上的相同位置

• options

需要。S3存储插件选项部分。 

        region

        AWS S3必需。如果连接到S3兼容服务，则不需要此选项

        endpoint

        S3兼容服务所必需的。 指定此选项可连接到S3兼容服务，例如ECS。 该插件连接到指定的S3端点（主机名或IP地址）以访问S3兼容的数据存储。如果指定了此选项，则插件将忽略region选项，并且不使用AWS来解析端点。 如果未指定此选项，插件将使用region来确定AWS S3端点

        aws_access_key_id

        可选的。用于访问存储备份文件的S3存储桶位置的S3 ID。如果未指定此参数，则使用来自会话环境的S3身份验证信息

        aws_secret_access_key

        仅在指定aws_access_key_id时才需要。S3 ID的S3密码，用于访问S3存储桶位置

        bucket

        需要。AWS区域或S3兼容数据存储中的S3存储桶的名称

        folder

        需要。备份的S3位置。在备份操作期间，如果S3存储桶中不存在，则插件会创建S3位置

        encryption

        可选的。连接到S3位置时启用或禁用安全套接字层（SSL）。 默认值为on，使用通过SSL保护的连接。将此选项设置为off以连接到未配置为使用SSL的S3兼容服务。除off之外的任何值都被视为on

        S3存储插件配置文件示例：

executablepath: $GPHOME/bin/gpbackup_s3_plugin
options:
region: us-west-2
aws_access_key_id: test-s3-user
aws_secret_access_key: asdf1234asdf
bucket: gpdb-backup
folder: test/backup3

        gpbackup使用S3存储插件备份数据库示例，S3存储插件配置文件的绝对路径是/home/gpadmin/s3-test。

gpbackup --dbname demo --plugin-config /home/gpadmin/s3-test-config.yaml

        S3存储插件将备份文件写入AWS区域us-west-2中的此S3位置：

gpdb-backup/test/backup3/backups/YYYYMMDD/YYYYMMDDHHMMSS/

        如果未在配置文件中指定aws_access_key_id和aws_secret_access_key，则S3插件将使用来自运行备份操作的会话的系统环境的S3身份验证信息。