Amazon Relational Database Service
用户指南 (API Version 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. 在导航窗格中,选择 DB Instances

  3. 选中您要重命名的数据库实例旁边的复选框。

  4. Instance Actions 下拉菜单中,选择 Modify

  5. DB Instance Identifier 文本框中,输入一个新名称。选中 Apply Immediately 复选框,然后单击 Continue

  6. 单击 Modify DB Instance,完成更改。

CLI

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

针对 Linux、OS X 或 Unix:

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

对于 Windows:

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

API

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

  • DBInstanceIdentifier = 实例的现有名称

  • NewDBInstanceIdentifier = 新的实例名称

Copy
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>

相关主题