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

重命名数据库实例

您可以使用 AWS 管理控制台、AWS CLI modify-db-instance 命令或 Amazon RDS API ModifyDBInstance 操作重命名数据库实例。重命名数据库实例会产生深远的影响;下面是您在重命名数据库实例前应知道的事情的列表。

  • 当您重命名数据库实例时,数据库实例的终端节点会发生更改,因为 URL 包含了您分配给数据库实例的名称。您应当始终将流量从旧的 URL 重定向到新的。

  • 当您重命名数据库实例时,数据库实例使用的旧的 DNS 名称会立刻被删除,尽管它可能会在缓存中保留几分钟。重命名数据库实例的新 DNS 名称大约在 10 分钟之内生效。重命名的数据库实例在新名称生效前不可用。

  • 重命名实例时,不能使用现有的数据库实例名称。

  • 重命名后,所有与数据库实例关联的只读副本会保持与该实例的关联。例如,假设您有一个为生产数据库服务的数据库实例,而该实例有多个关联的只读副本。如果您重命名该数据库实例,然后在生产环境中将其替换为数据库快照,则您重命名的数据库实例仍会拥有与它关联的只读副本。

  • 如果您重新使用数据库实例的名称,则与数据库实例的名称关联的指标和事件保持不变。例如,如果提升一个只读副本,然后将其重命名为以前主实例的名称,则与该主实例关联的事件和指标与重命名的实例关联。

  • 无论是否重命名,数据库实例标签会始终与数据库实例关联在一起。

  • 对于重命名的数据库实例,数据库快照也会保留下来。

重命名以替换现有的数据库实例

重命名数据库实例最常见的原因是要提升只读副本或从数据库快照或 PITR 还原数据。通过重命名数据库,您无需更改引用该数据库实例的任何应用程序代码,就可以替换数据库实例。在这些情况下,请执行以下操作:

  1. 停止传向主数据库实例的所有流量。这可能包括重定向访问数据库实例中数据库的流量,或采取阻止流量访问数据库实例中数据库的其他方法。

  2. 在重命名主数据库实例时,请使用一个表示它不再是本主题下文所述的主数据库实例的名称。

  3. 通过从数据库快照还原或提升只读副本而创建一个新的主数据库实例,然后将该实例命名为此前主数据库实例的名称。

  4. 将所有只读副本与新的主数据库实例关联。

如果您删除旧的主数据库实例,就必须删除旧的主数据库实例中所有不再需要的数据库快照。

有关提升只读副本的信息,请参阅将只读副本提升为独立的数据库实例

AWS 管理控制台

要重命名数据库实例,请执行以下操作:

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

  2. 在导航窗格中,选择 Instances

  3. 选择要重命名的数据库实例。

  4. 选择实例操作,然后选择修改

  5. 设置中,在数据库实例标识符框中输入新名称。

  6. 选择 Continue (继续)

  7. 要立即应用更改,请选择立即应用。选择此选项在某些情况下可导致中断。有关更多信息,请参阅立即应用的影响

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

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

CLI

要重命名数据库实例,请使用 AWS CLI 命令 modify-db-instance。提供当前 --db-instance-identifier 值并为 --new-db-instance-identifier 参数提供数据库实例的新名称。

针对 Linux、OS X 或 Unix:

aws rds modify-db-instance \ --db-instance-identifier DBInstanceIdentifier \ --new-db-instance-identifier NewDBInstanceIdentifier

对于 Windows:

aws rds modify-db-instance ^ --db-instance-identifier DBInstanceIdentifier ^ --new-db-instance-identifier NewDBInstanceIdentifier

API

要重命名数据库实例,请结合以下参数调用 Amazon RDS API 函数 ModifyDBInstance

  • DBInstanceIdentifier = 实例的现有名称

  • NewDBInstanceIdentifier = 新的实例名称

https://rds.amazonaws.com/ ?Action=ModifyDBInstance &DBInstanceIdentifier=mydbinstance &NewDBInstanceIdentifier=mynewdbinstanceidentifier &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2012-01-20T22%3A06%3A23.624Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>

相关主题