本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 重新命名資料庫執行個體
<a name="USER_RenameInstance"></a>

 您可以使用 AWS 管理主控台、AWS CLI `modify-db-instance` 命令或 Amazon RDS API `ModifyDBInstance` 動作重新命名資料庫執行個體。重新命名資料庫執行個體可以發揮深遠的效果。以下是您重新命名資料庫執行個體前的考量事項清單。
+  重新命名資料庫執行個體時，資料庫執行個體的端點會隨之變更，因為 URL 包含您指派給資料庫執行個體的名稱。您應該將流量從舊的 URL 重新導向到新的 URL。
+  重新命名資料庫執行個體時，資料庫執行個體所用的舊 DNS 名稱會立即刪除，不過其會保留在快取內幾分鐘。重新命名的資料庫執行個體的新 DNS 名稱會在大約 10 分鐘後生效。重新命名的資料庫執行個體必須等到新名稱生效後才可使用。
+  重新命名執行個體後，您將無法使用現有的資料庫執行個體名稱。
+  與資料庫執行個體關聯的所有僅供讀取複本在重新命名後仍會保持與該執行個體的關聯。例如，假設您有一個為生產資料庫服務的資料庫執行個體，且該執行個體有多個關聯的僅供讀取複本。如果您命名資料庫執行個體，接著在生產環境中將執行個體換成資料庫快照，重新命名後的資料庫執行個體仍有與其關聯的僅供讀取複本。
+  如果您重複使用資料庫執行個體名稱，與資料庫執行個體名稱關聯的指標和事件也會保留。例如，如果您提升僅供讀取複本，並將其重新命名為與先前主要資料庫執行個體相同的名稱，與主要資料庫執行個體相關聯的事件和指標將變成與重新命名後的執行個體相關聯。
+  資料庫執行個體標籤隨資料庫執行個體保留，無論是否重新命名。
+  重新命名的資料庫執行個體將保留其資料庫快照。

**注意**  
資料庫執行個體是在雲端執行的隔離資料庫環境。資料庫執行個體可以託管多個資料庫，也可以託管具有多個結構描述的單一 Oracle 資料庫。如需有關變更資料庫名稱的資訊，請參閱資料庫引擎相關文件。

## 重新命名以取代現有的資料庫執行個體
<a name="USER_RenameInstance.RR"></a>

重新命名資料庫執行個體最常見的原因，就是要提升僅供讀取複本，或從資料庫快照或 point-in-time 恢復 (PITR) 還原資料。透過重新命名資料庫的方式，您便能取代資料庫執行個體，而無需變更參考資料庫執行個體的任何應用程式碼。在這些情況下，您需執行下列動作：

1. 停止傳入主要資料庫執行個體的所有流量。這牽涉到重新導向流量，避免其存取資料庫執行個體上的資料庫，或您可用某些其他方式來避免流量存取資料庫執行個體上的資料庫。

1. 重新命名主要資料庫執行個體，名稱應指出其已不再是主要資料庫執行個體，如本主題稍後說明。

1. 從資料庫快照還原，或提升僅供讀取複本，以建立新的主要資料庫執行個體，然後將新執行個體命名為先前主要資料庫執行個體的名稱。

1. 將任何僅供讀取複本與新的主要資料庫執行個體建立關聯。

如果要刪除舊的主要資料庫執行個體，您也必須負責刪除舊的主要資料庫執行個體任何不想要的資料庫快照。

如需提升僅供讀取複本的相關資訊，請參閱 [提升僅供讀取複本為獨立的資料庫執行個體](USER_ReadRepl.Promote.md)。

**重要**  
資料庫執行個體會在重新命名後重新開機。對於已啟用 AlwaysOn 或鏡像選項的 RDS for SQL Server 多可用區執行個體，在重新命名操作後將執行個體重新開機時，預期會發生容錯移轉。

## 主控台
<a name="USER_RenameInstance.CON"></a>

**重新命名資料庫執行個體**

1. 登入 AWS 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。

1. 在導覽窗格中，選擇 **Databases (資料庫)**。

1. 選擇您想要重新命名的資料庫執行個體。

1. 選擇 **Modify (修改)**。

1. 在 **Settings (設定)** 中，針對 **DB instance identifier (資料庫執行個體識別符)**，輸入新名稱。

1. 選擇 **Continue (繼續)**。

1. 若要立即套用變更，請選擇 **Apply immediately** (立即套用)。在某些情況下，選擇此選項會導致停機。如需更多詳細資訊，請參閱 [修改 Amazon RDS 資料庫執行個體](Overview.DBInstance.Modifying.md)。

1. 在確認頁面上，檢閱您的變更。如果都正確，請選擇 **Modify DB Instance (修改資料庫執行個體)** 以儲存您的變更。

   或者，選擇 **Back (上一步)** 以編輯變更，或是選擇 **Cancel (取消)** 以取消變更。

## AWS CLI
<a name="USER_RenameInstance.CLI"></a>

若要重新命名資料庫執行個體，請使用 AWS CLI 命令 [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)。用資料庫執行個體的新名稱提供目前的 `--db-instance-identifier` 值和 `--new-db-instance-identifier` 參數。

**Example**  
針對 Linux、macOS 或 Unix：  

```
1. aws rds modify-db-instance \
2.     --db-instance-identifier DBInstanceIdentifier \
3.     --new-db-instance-identifier NewDBInstanceIdentifier
```
針對 Windows：  

```
1. aws rds modify-db-instance ^
2.     --db-instance-identifier DBInstanceIdentifier ^
3.     --new-db-instance-identifier NewDBInstanceIdentifier
```

## RDS API
<a name="USER_RenameInstance.API"></a>

若要重新命名資料庫執行個體，請搭配下列參數呼叫 Amazon RDS API 操作 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html)：
+ `DBInstanceIdentifier` — 執行個體的目前名稱
+ `NewDBInstanceIdentifier` — 執行個體的新名稱