Amazon Aurora
Aurora 用户指南 (API 版本 2014-10-31)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

修改 Amazon Aurora 数据库集群

您可以更改数据库集群的设置来完成更改其备份保留期或其数据库端口等任务。还可以修改数据库集群中的数据库实例来完成更改其数据库实例类或为其启用 Performance Insights 等任务。本主题指导您修改 Aurora 数据库集群及其数据库实例,并介绍每个实例的设置。

我们建议您在修改生产数据库集群或数据库实例之前在测试数据库集群或数据库实例上测试所有更改,以便完全了解每项更改的影响。在升级数据库版本时,这尤其重要。

使用控制台、CLI 和 API 修改数据库集群

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 修改数据库集群。

注意

对于 Aurora,在修改数据库集群时,仅数据库集群标识符IAM 数据库身份验证新建主密码设置的更改受立即应用设置的影响。所有其他修改会立即应用,而不管立即应用设置的值如何。

控制台

修改数据库集群

  1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择集群,然后选择要修改的数据库集群。

  3. 选择操作,然后选择修改集群。此时会显示修改数据库集群页面。

  4. 根据需要更改任意设置。有关每项设置的信息,请参阅 Amazon Aurora 设置

    注意

    在 AWS 管理控制台中,某些实例级别更改仅适用于当前数据库实例,而其他更改适用于整个数据库集群。有关设置是适用于数据库实例还是数据库集群的信息,请参阅Amazon Aurora 设置中的设置范围。要在 AWS 管理控制台中更改在实例级别修改整个数据库集群的设置,请按照修改数据库集群中的数据库实例中的说明操作。

  5. 当所有更改都达到您的要求时,选择继续并查看修改摘要。

  6. 要立即应用更改,请选择立即应用

  7. 在确认页面上,检查您的更改。如果更改正确无误,请选择修改集群以保存更改。

    或者,选择 Back 编辑您的更改,或者选择 Cancel 取消更改。

AWS CLI

要使用 AWS CLI 修改数据库集群,请调用 modify-db-cluster 命令。指定数据库集群标识符以及要修改的设置值。有关每项设置的信息,请参阅 Amazon Aurora 设置

注意

某些设置仅适用于数据库实例。要更改这些设置,请按照修改数据库集群中的数据库实例中的说明操作。

以下命令将备份保留期设置为 1 周(7 天)以修改 mydbcluster

针对 Linux、OS X 或 Unix:

aws rds modify-db-cluster \ --db-cluster-identifier mydbcluster \ --backup-retention-period 7

对于 Windows:

aws rds modify-db-cluster ^ --db-cluster-identifier mydbcluster ^ --backup-retention-period 7
RDS API

要使用 Amazon RDS API 修改数据库集群,请调用 ModifyDBCluster 操作。指定数据库集群标识符以及要修改的设置值。有关每个参数的信息,请参阅Amazon Aurora 设置

注意

某些设置仅适用于数据库实例。要更改这些设置,请按照修改数据库集群中的数据库实例中的说明操作。

修改数据库集群中的数据库实例

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 修改数据库集群中的数据库实例。

修改数据库实例后可以立即应用更改。要立即应用更改,可以在 AWS 管理控制台中选择立即应用选项,还可以在调用 AWS CLI 时使用 --apply-immediately 参数,或在使用 Amazon RDS API 时将 ApplyImmediately 参数设为 true

如果您没有选择立即应用更改,更改将被放置在等待修改队列中。队列中的所有等待更改都将在下一维护时段应用。如果您选择立即应用更改,将应用您的新更改以及等待修改队列中的所有更改。

重要

如果任何等待修改需要停机,选择立即应用可能会对该数据库实例导致意外停机。数据库集群中的其他数据库实例则无停机。

控制台

修改数据库集群中的数据库实例

  1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择 Instances,然后选择您希望修改的数据库实例。

  3. 选择实例操作,然后选择修改。此时会显示 Modify DB Instance (修改数据库实例) 页面。

  4. 根据需要更改任意设置。有关每项设置的信息,请参阅 Amazon Aurora 设置

    注意

    某些设置应用于整个数据库集群,并且必须在集群级别进行更改。要更改这些设置,请按照使用控制台、CLI 和 API 修改数据库集群中的说明操作。

    在 AWS 管理控制台中,某些实例级别更改仅适用于当前数据库实例,而其他更改适用于整个数据库集群。有关设置是适用于数据库实例还是数据库集群的信息,请参阅Amazon Aurora 设置中的设置范围。

  5. 当所有更改都达到您的要求时,选择继续并查看修改摘要。

  6. 要立即应用更改,请选择立即应用

  7. 在确认页面上,检查您的更改。如果更改正确无误,请选择 Modify DB Instance 保存更改。

    或者,选择 Back 编辑您的更改,或者选择 Cancel 取消更改。

AWS CLI

要使用 AWS CLI 修改数据库集群中的数据库实例,请调用 modify-db-instance 命令。指定数据库实例标识符以及要修改的设置值。有关每个参数的信息,请参阅Amazon Aurora 设置

注意

某些设置适用于整个数据库集群。要更改这些设置,请按照使用控制台、CLI 和 API 修改数据库集群中的说明操作。

以下代码将数据库实例类设置为 db.r4.xlarge 以修改 mydbinstance。将在下一维护时段使用 --no-apply-immediately 应用这些更改。使用 --apply-immediately 可立即应用更改。

针对 Linux、OS X 或 Unix:

aws rds modify-db-instance \ --db-instance-identifier mydbinstance \ --db-instance-class db.r4.xlarge \ --no-apply-immediately

对于 Windows:

aws rds modify-db-instance ^ --db-instance-identifier mydbinstance ^ --db-instance-class db.r4.xlarge ^ --no-apply-immediately
RDS API

要使用 Amazon RDS API 修改 MySQL 实例,请调用 ModifyDBInstance 操作。指定数据库实例标识符以及要修改的设置值。有关每个参数的信息,请参阅Amazon Aurora 设置

注意

某些设置适用于整个数据库集群。要更改这些设置,请按照使用控制台、CLI 和 API 修改数据库集群中的说明操作。

Amazon Aurora 设置

下表包含有关可修改的设置、修改设置的方法以及设置范围的详细信息。范围确定设置是适用于整个数据库集群,还是只能为特定数据库实例设定该设置。

设置和说明 方法 范围 停机说明

自动次要版本升级

是否希望数据库实例在首选次要引擎版本升级可用时自动接收该升级。只有在计划的维护时段内,才会安装升级。

自动次要版本升级设置仅适用于 Aurora PostgreSQL 数据库集群。

有关 Aurora PostgreSQL 引擎更新的更多信息,请参阅Amazon Aurora PostgreSQL 的数据库引擎更新

有关 Aurora MySQL 引擎更新的更多信息,请参阅Amazon Aurora MySQL 的数据库引擎更新

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --auto-minor-version-upgrade|--no-auto-minor-version-upgrade 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 AutoMinorVersionUpgrade 参数。

整个数据库集群

备份保留期

自动备份的保留天数。最小值为 1

有关更多信息,请参阅 备份

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --backup-retention-period 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 BackupRetentionPeriod 参数。

整个数据库集群

证书颁发机构

要使用的证书。

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --ca-certificate-identifier 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 CACertificateIdentifier 参数。

仅指定的数据库实例

数据 API

注意

对于 Aurora Serverless,数据 API 为测试版,可能会发生变化。

您可以使用基于 Web 服务的应用程序(包括 AWS Lambda 和 AWS AppSync)访问 Aurora Serverless。此设置仅适用于 Aurora Serverless 数据库集群。

有关更多信息,请参阅使用 Aurora Serverless 的数据 API

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --enable-http-endpoint 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 EnableHttpEndpoint 参数。

整个数据库集群

数据库端口

要用于访问数据库集群的端口。

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --port 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 Port 参数。

整个数据库集群

在此更改期间发生服务中断。将立即重新引导数据库集群中的所有数据库实例。

数据库集群标识符

数据库集群标识符。该值以一个小写字符串存储。

在更改数据库集群标识符时,将更改数据库集群终端节点以及数据库集群中的数据库实例的终端节点。

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --new-db-cluster-identifier 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 NewDBClusterIdentifier 参数。

整个数据库集群

数据库集群参数组

要与数据库集群关联的数据库集群参数组。

有关更多信息,请参阅 使用数据库参数组和数据库集群参数组

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --db-cluster-parameter-group-name 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 DBClusterParameterGroupName 参数。

整个数据库集群

在此更改期间,不会出现中断。当您更改参数组时,对某些参数的更改将立即应用于数据库集群中的数据库实例,而无需重新启动。而对其他一些参数进行的更改,只有在重新启动数据库集群中的数据库实例之后,才会应用。

数据库引擎版本

要使用的数据库引擎的版本。在升级生产数据库集群之前,我们建议您在测试数据库集群上测试升级过程以验证其持续时间以及您的应用程序。

目前,您只能使用该设置升级 Aurora PostgreSQL 数据库集群的次要引擎版本。

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --engine-version 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 EngineVersion 参数。

整个数据库集群

在此更改期间发生服务中断。

数据库实例类

您要使用的数据库实例类。

有关更多信息,请参阅 选择数据库实例类

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --db-instance-class 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 DBInstanceClass 参数。

仅指定的数据库实例

在此更改期间发生服务中断。

数据库实例标识符

数据库实例标识符。该值以一个小写字符串存储。

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --new-db-instance-identifier 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 NewDBInstanceIdentifier 参数。

仅指定的数据库实例

在此更改期间发生服务中断。数据库实例重启。

数据库参数组

要与数据库实例关联的数据库参数组。

有关更多信息,请参阅 使用数据库参数组和数据库集群参数组

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --db-parameter-group-name 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 DBParameterGroupName 参数。

仅指定的数据库实例

在此更改期间,不会出现中断。当您更改参数组时,对某些参数的更改将立即应用于数据库实例,而无需重新启动。而对其他一些参数进行的更改,只有在重新启动数据库实例之后,才会应用。

删除保护

启用删除保护以禁止删除数据库集群。有关更多信息,请参阅删除数据库集群中的数据库实例

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --deletion-protection|--no-deletion-protection 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 DeletionProtection 参数。

整个数据库集群

增强监测

启用增强监测可启用您的数据库实例在其上运行的操作系统的实时指标收集。

有关更多信息,请参阅 增强监测

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --monitoring-role-arn--monitoring-interval 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 MonitoringRoleArnMonitoringInterval 参数。

仅指定的数据库实例

IAM 数据库身份验证

启用 IAM 数据库身份验证,以便为该数据库集群启用 IAM 数据库身份验证。该设置仅适用于 Aurora MySQL。

有关更多信息,请参阅 的 IAM 数据库身份验证

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --enable-iam-database-authentication|--no-enable-iam-database-authentication 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 EnableIAMDatabaseAuthentication 参数。

整个数据库集群

日志导出

选择要发布到 Amazon CloudWatch Logs 的日志类型。

有关更多信息,请参阅 MySQL 数据库日志文件

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --cloudwatch-logs-export-configuration 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 CloudwatchLogsExportConfiguration 参数。

整个数据库集群

维护时段

进行系统维护的时间范围。维护系统包括升级 (如果适用)。维护时段是开始时间 (采用通用协调时间 (UTC)) 和持续时间 (以小时为单位)。

如果将时段设置为当前时间,则当前时间与该时段结束之间必须相隔至少 30 分钟以确保应用所有待处理的更改。

您可以为数据库集群以及数据库集群中的每个数据库实例单独设置维护时段。在修改范围是整个数据库集群时,将在数据库集群的维护时段执行修改。在修改范围是数据库实例时,将在该数据库实例的维护时段执行修改。

有关更多信息,请参阅 Amazon RDS 维护时段

要使用 AWS 管理控制台更改数据库集群的维护时段,请参阅使用控制台、CLI 和 API 修改数据库集群

要使用 AWS 管理控制台更改数据库实例的维护时段,请参阅修改数据库集群中的数据库实例

要使用 AWS CLI 更改数据库集群的维护时段,请运行 modify-db-cluster 并设置 --preferred-maintenance-window 选项。

要使用 AWS CLI 更改数据库实例的维护时段,请运行 modify-db-instance 并设置 --preferred-maintenance-window 选项。

要使用 RDS API 更改数据库集群的维护时段,请调用 ModifyDBCluster 并设置 PreferredMaintenanceWindow 参数。

要使用 RDS API 更改数据库实例的维护时段,请调用 ModifyDBInstance 并设置 PreferredMaintenanceWindow 参数。

整个数据库集群或单个数据库实例

如果有一个或多个待处理的操作导致服务中断,并且维护时段经过更改,加入了当前时间,则立即应用这些待处理的操作并会出现中断。

新建主密码

您的主用户密码。密码必须包含 8 到 41 个字母数字字符。

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --master-user-password 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 MasterUserPassword 参数。

整个数据库集群

Performance Insights

是否启用 Performance Insights,该工具监控数据库实例负载,以便您可以分析数据库性能以及解决数据库性能问题。

有关更多信息,请参阅 使用 Amazon RDS Performance Insights

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --enable-performance-insights|--no-enable-performance-insights 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 EnablePerformanceInsights 参数。

仅指定的数据库实例

Performance Insights AWS KMS 密钥标识符

用于加密 Performance Insights 数据的 AWS KMS 密钥标识符。KMS 密钥 ID 是 Amazon 资源名称 (ARN)、KMS 密钥标识符或 KMS 加密密钥的 KMS 密钥别名。

有关更多信息,请参阅 启用 Performance Insights

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --performance-insights-kms-key-id 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 PerformanceInsightsKMSKeyId 参数。

仅指定的数据库实例

Performance Insights 保留期

保留 Performance Insights 数据的时间(天)。有效值为 7 或 731(2 年)。

有关更多信息,请参阅 启用 Performance Insights

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --performance-insights-retention-period 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 PerformanceInsightsRetentionPeriod 参数。

仅指定的数据库实例

提升层

该值指定在现有主实例发生故障后将 Aurora 副本提升为主实例的顺序。

有关更多信息,请参阅 Aurora 数据库集群的容错能力

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --promotion-tier 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 PromotionTier 参数。

仅指定的数据库实例

公开可用性

是否为数据库实例提供公有 IP 地址,这表示可以在 VPC 外部访问该实例。要可供公开访问,数据库实例还必须在 VPC 的公有子网中。在无法公开访问数据库实例时,只能从 VPC 中访问该实例。

有关更多信息,请参阅 从 Internet 隐藏 VPC 中的数据库实例

通过使用 AWS 管理控制台,修改数据库集群中的数据库实例

通过使用 AWS CLI,运行 modify-db-instance 并设置 --publicly-accessible|--no-publicly-accessible 选项。

通过使用 RDS API,调用 ModifyDBInstance 并设置 PubliclyAccessible 参数。

仅指定的数据库实例

扩展配置

数据库集群的扩展属性。您只能在 serverless 数据库引擎模式下修改数据库集群的扩展属性。该设置仅适用于 Aurora MySQL。

有关 Aurora Serverless 的信息,请参阅使用 Amazon Aurora Serverless

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --scaling-configuration 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 ScalingConfiguration 参数。

整个数据库集群

安全组

要与数据库集群关联的安全组。

有关更多信息,请参阅 使用安全组控制访问权限

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --vpc-security-group-ids 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 VpcSecurityGroupIds 参数。

整个数据库集群

目标回溯时段

您希望能够回溯数据库集群的时间长度(秒)。该设置仅适用于 Aurora MySQL;只有在启用了回溯的情况下创建数据库集群时才可用。

通过使用 AWS 管理控制台,使用控制台、CLI 和 API 修改数据库集群

通过使用 AWS CLI,运行 modify-db-cluster 并设置 --backtrack-window 选项。

通过使用 RDS API,调用 ModifyDBCluster 并设置 BacktrackWindow 参数。

整个数据库集群

不适用于 Amazon Aurora 的设置

AWS CLI 命令 modify-db-instance 和 RDS API 操作 ModifyDBInstance 中的以下设置不适用于 Amazon Aurora。

注意

AWS 管理控制台不允许您修改 Aurora 的这些设置。

AWS CLI 设置 RDS API 设置

--allocated-storage

AllocatedStorage

--allow-major-version-upgrade|--no-allow-major-version-upgrade

AllowMajorVersionUpgrade

--copy-tags-to-snapshot|--no-copy-tags-to-snapshot

CopyTagsToSnapshot

--domain

Domain

--db-security-groups

DBSecurityGroups

--db-subnet-group-name

DBSubnetGroupName

--domain-iam-role-name

DomainIAMRoleName

--multi-az|--no-multi-az

MultiAZ

--iops

Iops

--license-model

LicenseModel

--option-group-name

OptionGroupName

--preferred-backup-window

PreferredBackupWindow

--processor-features

ProcessorFeatures

--storage-type

StorageType

--tde-credential-arn

TdeCredentialArn

--tde-credential-password

TdeCredentialPassword

--use-default-processor-features|--no-use-default-processor-features

UseDefaultProcessorFeatures

注意

虽然可以为 Aurora 设置首选的备份时段,但会忽略该设置。Aurora 备份是连续且递增的。