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

# 啟動 SQL Server 切換
<a name="sqlserver-switchover.initiating"></a>

您可以將 RDS for SQL Server 僅供讀取複本切換為主要角色，並將先前的主要資料庫執行個體切換為複本角色。

啟動切換之前，請確認下列事項：
+ `ReplicaLag` CloudWatch 指標為零或接近零。
+ 主要資料庫上沒有作用中的長時間執行交易。
+ 您的應用程式連線字串已設定為處理端點變更，或者您有計畫在切換後更新它們。
+ 您已驗證複本處於運作狀態 （狀態為 `available`)。

您可以使用 Amazon RDS 主控台 AWS CLI、 或 Amazon RDS API 啟動切換。

## 主控台
<a name="sqlserver-switchover.initiating.console"></a>

**將 SQL Server 僅供讀取複本切換至主要資料庫角色**

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

1. 在 Amazon RDS 主控台，選擇 **Databases (資料庫)**。

   **Databases (資料庫)** 窗格隨即出現。每個僅供讀取複本會在 **Role (角色)** 欄中顯示 **Replica (複本)**。

1. 選擇您要容錯移轉為主要角色的僅供讀取複本。

1. 對於 **Actions** (動作)，選擇 **Switch over replica** (容錯移轉複本)。

1. 選擇 **I acknowledge** (我確認)。然後選擇 **Switch over replica** (容錯移轉複本)。

1. 在 **Databases** (資料庫) 頁面上監控容錯移轉進度。

   容錯移轉完成時，容錯移轉目標的角色會從 **Replica** (複本) 變成 **Source** (來源)。

## AWS CLI
<a name="sqlserver-switchover.initiating.cli"></a>

若要將 SQL Server 複本切換到主要資料庫角色，請使用 AWS CLI [switchover-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html) 命令。下列範例會將名為 {{replica-to-be-made-primary}} 的 SQL Server 複本轉換為新的主要資料庫執行個體。

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

```
aws rds switchover-read-replica \
    --db-instance-identifier {{replica-to-be-made-primary}}
```
在 Windows 中：  

```
aws rds switchover-read-replica ^
    --db-instance-identifier {{replica-to-be-made-primary}}
```

## RDS API
<a name="sqlserver-switchover.initiating.api"></a>

若要將 SQL Server 複本切換至主要資料庫角色，請使用必要的參數 呼叫 Amazon RDS API 的 [SwitchoverReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) 操作`DBInstanceIdentifier`。此參數指定您要擔任主要資料庫角色的 SQL Server 複本名稱。