本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 Amazon DocumentDB 執行個體
下列主題提供的資訊可協助您管理 Amazon DocumentDB 執行個體。當中包括有關執行個體類別和狀態，以及如何建立、刪除和修改執行個體的詳細資訊。
**Topics**
+ [判斷執行個體的狀態](#db-instance-status)
+ [執行個體生命週期](db-instance-life-cycle.md)
+ [管理執行個體類別](db-instance-classes.md)
+ [NVMe 支援的執行個體](db-instance-nvme.md)
## 判斷執行個體的狀態
若要查看有效的執行個體狀態、它們的意義，以及如何判斷執行個體狀態的詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
# Amazon DocumentDB 執行個體生命週期
Amazon DocumentDB 執行個體的生命週期包括建立、修改、維護和升級、執行備份和還原、重新啟動和刪除執行個體。本節提供如何完成這些程序的相關資訊。
**Topics**
+ [新增執行個體](db-instance-add.md)
+ [描述執行個體](db-instance-view-details.md)
+ [修改執行個體](db-instance-modify.md)
+ [重新啟動執行個體](db-instance-reboot.md)
+ [刪除執行個體](db-instance-delete.md)
您可以使用 AWS 管理主控台 或 建立新的 Amazon DocumentDB 執行個體 AWS CLI。若要將執行個體新增至叢集，叢集必須處於*可用*狀態。您無法將執行個體新增至已停止的叢集。如果叢集已停止，請先啟動叢集，等待叢集變成*可用*，然後新增執行個體。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
**注意**
如果您使用主控台建立 Amazon DocumentDB 叢集，系統會自動為您同時建立執行個體。如果您要建立其他執行個體，請使用下列程序之一。
# 將 Amazon DocumentDB 執行個體新增至叢集
------
#### [ Using the AWS 管理主控台 ]
使用下列程序，使用 Amazon DocumentDB 主控台為您的叢集建立執行個體。
1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 若要選擇要新增執行個體的叢集，請選取叢集名稱左側的按鈕。
1. 選擇 **Actions (動作)**，然後選擇 **Add instances (新增執行個體)**。
1. 在 **Add instance to: (新增執行個體至)** 頁面，針對您想要加到叢集的每個執行個體重複以下步驟。您最多可以有 15 個。
1. **執行個體識別符** — 您可以為此執行個體輸入唯一識別符，或允許 Amazon DocumentDB 根據叢集識別符提供執行個體識別符。
執行個體命名限制：
+ 長度為 【1-63】 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
+ 對於每個區域每個 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有執行個體 AWS 帳戶，必須是唯一的。
1. **執行個體類別** — 從下拉式清單中，選擇您想要用於此執行個體的執行個體類型。
1. **提升方案**：從下拉式清單中，選擇執行個體的提升方案，或選擇*無偏好設定*，以允許 Amazon DocumentDB 為您的執行個體設定提升方案。數字越小表示優先順序越高。如需詳細資訊，請參閱[控制容錯移轉目標](failover.md#failover-target_control)。
1. 若要新增更多執行個體，請選擇 **Add additional instances (新增其他執行個體)**，然後重複步驟 a、b 和 c。
1. 完成操作。
+ 若要新增執行個體到您的叢集，請選擇 **Create (建立)**。
+ 若要取消操作，請選擇 **Cancel (取消)**。
建立執行個體需要幾分鐘才能完成。您可以使用 主控台或 AWS CLI 來檢視執行個體的狀態。如需詳細資訊，請參閱[監控執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
使用 `create-db-instance` AWS CLI 操作搭配下列參數，為您的叢集建立主要執行個體。
+ **--db-instance-class** – 必要。執行個體的運算與記憶體容量，例如 `db.m4.large`。並非所有執行個體類別都可在所有 中使用 AWS 區域。
+ **--db-instance-identifier** – 必要。識別執行個體的字串。
執行個體命名限制條件：
+ 長度為 【1-63】 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
+ 對於每個區域每個 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有執行個體 AWS 帳戶，必須是唯一的。
+ **--engine** – 必要。必須為 `docdb`。
+ **--availability-zone** — 選用。要在其中建立執行個體的可用區域。使用此參數尋找不同可用區域中的執行個體，以提高容錯能力。如需詳細資訊，請參閱[Amazon DocumentDB 高可用性和複寫](replication.md)。
+ **--promotion-tier** — 選用。此執行個體的容錯移轉優先順序方案。必須介於 0 和 15 之間，數字越小優先順序越高。如需詳細資訊，請參閱[控制容錯移轉目標](failover.md#failover-target_control)。
1. **首先，決定您可以在其中建立執行個體的可用區域。**
如果您想要在建立執行個體之前指定可用區域，請執行下列命令來判斷哪些可用區域可供您的 Amazon DocumentDB 叢集使用。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
針對 Windows：
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
此操作的輸出將會如下所示。
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **其次，判定您可以在區域中建立哪些執行個體類別。 **
若要判斷您區域中可用的執行個體類別，請執行以下命令。從輸出中，為您要新增至 Amazon DocumentDB 叢集的執行個體選擇執行個體類別。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
針對 Windows：
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
此操作的輸出將會如下所示。
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **最後，將執行個體新增至 Amazon DocumentDB 叢集。**
若要將執行個體新增至 Amazon DocumentDB 叢集，請執行下列命令。
針對 Linux、macOS 或 Unix：
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
針對 Windows：
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
建立執行個體需要幾分鐘才能完成。您可以使用 主控台或 AWS CLI 來檢視執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 描述 Amazon DocumentDB 執行個體
您可以使用 Amazon DocumentDB 管理主控台或 查看 AWS CLI 連線端點、安全群組 VPCs、憑證授權單位和與 Amazon DocumentDB 執行個體相關的參數群組等詳細資訊。
------
#### [ Using the AWS 管理主控台 ]
若要使用 AWS 管理主控台檢視執行個體的詳細資訊，請依照下列步驟操作。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 在執行個體清單中，選擇您要查看其詳細資訊的執行個體名稱。執行個體的相關資訊分為下列群組：
+ **摘要** - 執行個體的一般資訊，包括引擎版本、類別、狀態和任何待定維護。
+ **連線與安全性** — **Connect** 區段列出使用 mongo shell 或 應用程式連線至此執行個體的連線端點。**Seucirty Groups (安全群組)** 區段會列出與此執行個體相關聯的安全群組，以及其 VPC ID 和描述。
+ **組態** - **詳細資訊**區段列出執行個體的組態和狀態，包括執行個體的 Amazon Resource Name (ARN)、端點、角色、類別和憑證授權單位。它也會列出執行個體的安全性和網路設定，以及備份資訊。**Cluster details (叢集詳細資訊)** 區段會列出此執行個體所屬叢集的詳細資訊。**Cluster instances (叢集執行個體)** 區段會列出屬於您叢集的所有執行個體，當中每個執行個體的角色和叢集參數群組狀態。
**注意**
您可以透過選取叢集詳細資訊標頭旁的**修改**，來修改與執行個體相關聯的叢集。 ****如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。
+ **監控** - 此執行個體的 CloudWatch Logs 指標。如需詳細資訊，請參閱[使用 CloudWatch 監控 Amazon DocumentDB](cloud_watch.md)。
+ **事件和標籤** — **最近事件**區段列出此執行個體的最近事件。Amazon DocumentDB 會保留與叢集、執行個體、快照、安全群組和叢集參數群組相關的事件記錄。此資訊包括與每個事件相關聯的日期、時間和訊息。**Tags (標籤)** 區段會列出連接至此叢集的標籤。如需詳細資訊，請參閱[標記 Amazon DocumentDB 資源](tagging.md)。
------
#### [ Using the AWS CLI ]
若要使用 檢視 Amazon DocumentDB 執行個體的詳細資訊 AWS CLI，請使用 `describe-db-clusters`命令，如以下範例所示。如需詳細資訊，請參閱《*Amazon DocumentDB Resource Management API 參考*[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)》中的 。
**注意**
對於特定管理功能，例如叢集和執行個體生命週期管理，Amazon DocumentDB 會利用與 Amazon RDS 共用的操作技術。`filterName=engine,Values=docdb` 篩選條件參數只會傳回 Amazon DocumentDB 叢集。
1. **列出所有 Amazon DocumentDB 執行個體。**
下列 AWS CLI 程式碼列出區域中所有 Amazon DocumentDB 執行個體的詳細資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
針對 Windows：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **列出指定 Amazon DocumentDB 執行個體的所有詳細資訊**
以下程式碼會列出 `sample-cluster-instance` 的詳細資訊。將 `--db-instance-identifier` 參數加入執行個體名稱會將輸出限制為該特定執行個體的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
針對 Windows：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
此操作的輸出如下所示：
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 修改 Amazon DocumentDB 執行個體
您可以使用 AWS 管理主控台 或 來修改 Amazon DocumentDB 執行個體 AWS CLI。若要修改執行個體，執行個體必須處於*可用*狀態。您無法修改已停止的執行個體。如果叢集已停止，請先啟動叢集，等待執行個體變成*可用*，然後進行所需的修改。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理主控台 ]
若要使用主控台修改特定 Amazon DocumentDB 執行個體，請完成下列步驟。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要修改之執行個體左側的方塊。
1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。
1. 在 **Modify instance: (修改執行個體：<執行個體-名稱>** 窗格中，進行您想要的變更。您可進行下列變更。
+ **執行個體規格** — 執行個體識別符和類別。執行個體識別符命名限制：
+ **執行個體識別符** — 為 AWS 帳戶 目前區域中 擁有的所有執行個體輸入唯一的名稱。執行個體識別符必須包含 【1-63】 個英數字元或連字號、以字母做為第一個字元，且不能以連字號結尾或包含兩個連續連字號。
+ **執行個體類別** — 從下拉式功能表中，選取 Amazon DocumentDB 執行個體的執行個體類別。如需詳細資訊，請參閱[管理執行個體類別](db-instance-classes.md)。
+ **憑證授權機構** — 此執行個體的伺服器憑證。如需詳細資訊，請參閱[更新您的 Amazon DocumentDB TLS 憑證](ca_cert_rotation.md)。
+ **容錯移轉** — 在容錯移轉期間，具有最高提升層的執行個體將提升為主要執行個體。如需詳細資訊，請參閱[Amazon DocumentDB 容錯移轉](failover.md)。
+ **維護** — 將待定修改或修補程式套用至叢集中執行個體的維護時段。
1. 完成後，請選擇 **Continue (繼續)** 以查看變更的摘要。
1. 確認變更後，即可立即套用，或是在下一個維護時段在 **Scheduling of modifications (修改的排程)** 下套用。選擇 **Modify Instance (修改執行個體)**，以儲存變更。或者，您可以選擇 **Cancel (取消)** 以捨棄變更。
套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
若要使用 修改特定 Amazon DocumentDB 執行個體 AWS CLI，請使用 `modify-db-instance`搭配下列參數。如需詳細資訊，請參閱 [ ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)。以下程式碼將執行個體 `sample-instance` 的執行個體類別修改為 `db.r5.large`。
**Parameters**
+ **--db-instance-identifier** – 必要。要修改的執行個體識別碼。
+ **--db-instance-class** — 選用。執行個體的新運算和記憶體容量；例如 `db.r5.large`。並非所有執行個體類別都可在所有 中使用 AWS 區域。如果您修改執行個體類別，則會在變更期間發生中斷。除非此請求`ApplyImmediately`指定為 true，否則變更會在下一個維護時段套用。
+ **--apply-immediately** 或 **--no-apply-immediately** — 選用。指定這項修改應立即套用，或等到下一次維護時段才套用。若省略此參數，則會在下一次維護時段進行修改。
**Example**
針對 Linux、macOS 或 Unix：
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
針對 Windows：
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
此操作的輸出將會如下所示。
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
套用您的修改需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的執行個體。您可以使用 AWS 管理主控台 或 監控執行個體的狀態 AWS CLI。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 重新啟動 Amazon DocumentDB 執行個體
有時，您可能需要重新啟動 Amazon DocumentDB 執行個體，通常是基於維護原因。如果您進行某些變更，例如變更與叢集相關聯的叢集參數群組，則必須重新啟動叢集中的執行個體讓變更生效。您可以使用 AWS 管理主控台 或 重新啟動指定的執行個體 AWS CLI。
重新啟動執行個體，將重新啟動資料庫引擎服務。重新啟動會導致暫時中斷，在此期間，執行個體狀態會設定為 `rebooting`。重新啟動完成時，會建立 Amazon DocumentDB 事件。
重新啟動執行個體不會導致容錯移轉。若要容錯移轉 Amazon DocumentDB 叢集，請使用 AWS 管理主控台 或 AWS CLI 操作 `failover-db-cluster`。如需詳細資訊，請參閱[Amazon DocumentDB 容錯移轉](failover.md)。
如果執行個體不是*可用*狀態，就無法重新啟動執行個體。資料庫無法使用可能由多種原因導致，例如，先前要求的修改，或維護時段的動作。如需執行個體狀態的詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS 管理主控台 ]
以下程序會重新啟動您使用主控台指定的執行個體。
1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要重新啟動之執行個體左側的方塊。
1. 選擇**Actions (動作)**、選擇 **Reboot (重新啟動)**，然後選擇 **Reboot (重新啟動)** 以確認重新啟動。
執行個體重新啟動需要幾分鐘的時間來完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
若要重新啟動 Amazon DocumentDB 執行個體，請使用 `reboot-db-instance`操作搭配 `--db-instance-identifier` 參數。此參數會指定要重新啟動之執行個體的識別符。
以下程式碼會重新啟動執行個體 `sample-instance`。
**Example**
針對 Linux、macOS 或 Unix：
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
針對 Windows：
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
執行個體重新啟動需要幾分鐘的時間來完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 刪除 Amazon DocumentDB 執行個體
您可以使用 AWS 管理主控台 或 刪除 Amazon DocumentDB 執行個體 AWS CLI。若要刪除執行個體，執行個體必須處於*可用*狀態。您無法刪除已停止的執行個體。如果包含執行個體的 Amazon DocumentDB 叢集已停止，請先啟動叢集，等待執行個體變成*可用*，然後刪除執行個體。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
**注意**
Amazon DocumentDB 會將所有資料存放在叢集磁碟區中。資料會保留在該叢集磁碟區中，即使您移除叢集中的所有執行個體也一樣。如果您需要再次存取資料，可以隨時新增執行個體至叢集，並從您上次離開的位置繼續操作。
------
#### [ Using the AWS 管理主控台 ]
下列程序會使用主控台刪除指定的 Amazon DocumentDB 執行個體。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要刪除之執行個體左側的方塊。
1. 選取 **Actions (動作)**，然後選擇 **Delete (刪除)**。
1. 如果您要刪除叢集中的最後一個執行個體：
+ **Create final cluster snapshot? (建立最終叢集快照？)** — 如果您想要在刪除叢集之前建立最終快照，請選擇**是**。否則請選擇**否**。
+ **最終快照名稱** — 如果您選擇建立最終快照，請輸入所建立新叢集快照的叢集快照識別符。
+ **Delete instance? (刪除 執行個體？)** — 在欄位中輸入**刪除整個叢集**的片語，以確認刪除。
1. 如果您不是刪除叢集中的最後一個執行個體：
+ **Delete instance? (刪除 執行個體？)** — 在欄位中輸入刪除**我**以確認刪除的片語。
1. 選取 **Delete (刪除)** 以刪除執行個體。
刪除執行個體需要幾分鐘的時間。若要監控執行個體的狀態，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
下列程序會使用 刪除 Amazon DocumentDB 執行個體 AWS CLI。
1. **首先，判斷您的 Amazon DocumentDB 叢集中有多少執行個體：**
若要判斷叢集中有多少執行個體，請執行 `describe-db-clusters` 命令，如下所示。
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
此操作的輸出將會如下所示。
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **如果您的 Amazon DocumentDB 叢集中有多個執行個體：**
若要刪除指定的 Amazon DocumentDB 執行個體，請使用 `delete-db-instance`命令搭配 `--db-instance-identifier` 參數，如下所示。刪除執行個體需要幾分鐘的時間。若要監控執行個體的狀態，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **如果您要刪除的執行個體是 Amazon DocumentDB 叢集中的最後一個執行個體： **
如果您刪除 Amazon DocumentDB 叢集中的最後一個執行個體，您也會刪除該叢集，以及與該叢集相關聯的自動快照和持續備份。
若要刪除叢集中的最後一個執行個體，您可以刪除該叢集並選擇性地建立最終快照。如需詳細資訊，請參閱[刪除 Amazon DocumentDB 叢集](db-cluster-delete.md)。
------
## 刪除保護
刪除 Amazon DocumentDB 叢集的最後一個執行個體也會刪除叢集，以及與該叢集相關聯的自動快照和持續備份。無論您是使用 AWS 管理主控台 或 執行刪除操作，Amazon DocumentDB 都會對叢集強制執行刪除保護 AWS CLI。如果已啟用刪除保護，您就無法刪除叢集。
若要刪除已啟用刪除保護的叢集，您必須先修改叢集並停用刪除保護。如需詳細資訊，請參閱[刪除 Amazon DocumentDB 叢集](db-cluster-delete.md)。
# 管理執行個體類別
執行個體類別會決定 Amazon DocumentDB （具有 MongoDB 相容性） 執行個體的運算和記憶體容量。您需要的執行個體類別取決於您的處理能力和記憶體需求。
Amazon DocumentDB 支援執行個體類別的 R4, R5, R6G, R8G, T3 和 T4G 系列。這些類別是新一代的執行個體類別，已針對記憶體密集型應用程式進行最佳化處理。如需這些類別的規格，請參閱[執行個體類別規格](#db-instance-class-specs)。
**Topics**
+ [判斷執行個體類別](#db-instance-class-determining)
+ [變更執行個體的類別](#db-instance-class-changing)
+ [各區域的支援執行個體類別](#db-instance-classes-by-region)
+ [執行個體類別規格](#db-instance-class-specs)
## 判斷執行個體類別
若要判斷執行個體的類別，您可以使用 AWS 管理主控台 或 `describe-db-instances` AWS CLI 操作。
------
#### [ Using the AWS 管理主控台 ]
若要判斷叢集執行個體的執行個體類別，請在 主控台中完成下列步驟。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**以尋找您感興趣的執行個體。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示如何在叢集下巢狀化執行個體。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 在執行個體清單中，展開叢集以尋找您感興趣的執行個體。尋找您想要的執行個體。然後，查看執行個體資料列的大小****欄，以查看其執行個體類別。
在下圖中，執行個體 `robo3t` 的執行個體類別為 `db.r5.4xlarge`。
![\[叢集資料表中的執行個體清單，其大小欄顯示執行個體類型。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
若要使用 判斷執行個體的類別 AWS CLI，請使用 `describe-db-instances`操作搭配下列參數。
+ **--db-instance-identifier** — 選用。指定您要尋找其執行個體類別的執行個體。如果省略這個參數，`describe-db-instances` 會傳回最多 100 個執行個體的敘述。
+ **--query** — 選用。指定要納入結果中的執行個體成員。如果省略此參數，則所有執行個體成員都會傳回。
**Example**
下列範例會尋找執行個體 的執行個體名稱和類別`sample-instance-1`。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
針對 Windows：
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
此操作的輸出將會如下所示。
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
下列範例會尋找最多 100 個 Amazon DocumentDB 執行個體的執行個體名稱和類別。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
針對 Windows：
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
此操作的輸出將會如下所示。
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
如需詳細資訊，請參閱[描述 Amazon DocumentDB 執行個體](db-instance-view-details.md)。
------
## 變更執行個體的類別
您可以使用 AWS 管理主控台 或 變更執行個體的執行個體類別 AWS CLI。如需詳細資訊，請參閱[修改 Amazon DocumentDB 執行個體](db-instance-modify.md)。
## 各區域的支援執行個體類別
Amazon DocumentDB 支援下列執行個體類別：
+ `R8G`- 最新一代採用 Arm 型 AWS Graviton4 處理器的記憶體最佳化執行個體，可提供比 R6G 執行個體高達 30% 的效能。
+ `R6G`- 採用 Arm 型 AWS Graviton2 處理器的記憶體最佳化執行個體，相較於 R5 執行個體，效能提升高達 30%，且成本降低 5%。
+ `R6GD`- 記憶體最佳化 R6G 執行個體，具有適用於暫時性資料的本機非揮發性記憶體快速 (NVMe) 型固態硬碟 (SSD) 儲存體。
+ `R5`- 記憶體最佳化執行個體，以相同的執行個體成本提供比 R4 執行個體高達 100% 更佳的效能。
+ `R4`- 先前產生記憶體最佳化的執行個體。
+ `T4G`：最新一代的低成本爆量一般用途執行個體類型，採用 Arm 型 AWS Graviton2 處理器，可提供基準層級的 CPU 效能，比 T3 執行個體提供高達 35% 的更佳價格效能，非常適合使用中等 CPU 用量的應用程式，這些應用程式在使用時遇到暫時性尖峰。
+ `T3`- 低成本爆量一般用途執行個體類型，可提供 CPU 效能的基準層級，並可視需要隨時爆量 CPU 用量。
如需這些執行個體類別的詳細規格，請參閱[執行個體類別規格](#db-instance-class-specs)。
**注意**
I/O 最佳化儲存僅適用於引擎版本 5.0 和 8.0 （執行個體型叢集）。
特定 區域不一定支援特定執行個體類別。下表指定 Amazon DocumentDB 在每個區域中支援哪些執行個體類別。
**各區域的支援執行個體類別**
| | 執行個體類別 | 區域 | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | 無伺服器 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 美國東部 (俄亥俄) | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 |
| 美國東部 (維吉尼亞北部) | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 |
| 美國西部 (奧勒岡) | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 |
| 非洲 (開普敦) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 南美洲 (聖保羅) | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (香港) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (海德拉巴) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (馬來西亞) | | | 支援 | | | 支援 | 支援 | |
| 亞太地區 (孟買) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (大阪) | | 支援 | 支援 | 支援 | | 支援 | 支援 | |
| 亞太地區 (首爾) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (悉尼) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太地區 (雅加達) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | |
| 亞太地區 (墨爾本) | | | 支援 | 支援 | | 支援 | 支援 | |
| 亞太地區 (新加坡) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 亞太區域 (泰國) | | | 支援 | | | 支援 | 支援 | |
| 亞太地區 (東京) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 加拿大 (中部) | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 歐洲 (法蘭克福) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 歐洲 (蘇黎世) | | 支援 | 支援 | 支援 | | 支援 | 支援 | |
| 歐洲 (愛爾蘭) | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 | 支援 |
| 歐洲 (倫敦) | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 歐洲 (米蘭) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| Europe (Paris) | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 歐洲 (西班牙) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 歐洲 (斯德哥爾摩) | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | |
| 墨西哥 (中部) | | | 支援 | | | 支援 | 支援 | |
| 中東 (阿拉伯聯合大公國) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 中國 (北京) | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 中國 (寧夏) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| 以色列 (特拉維夫) | | | 支援 | 支援 | | 支援 | 支援 | 支援 |
| AWS GovCloud （美國西部） | 支援 | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
| AWS GovCloud （美國東部） | | 支援 | 支援 | 支援 | | 支援 | 支援 | 支援 |
## 執行個體類別規格
下表提供 Amazon DocumentDB 執行個體類別的詳細資訊，包括每個類別中支援的執行個體類型。您可以在表的下方找到每個表格欄的說明。
| 執行個體類別 | vCPU1 | 記憶體 (GiB)2 | NVMe SSD 分層快取 (GiB)3 | 最大溫度儲存 (GiB)4 | 基準/高載頻寬 (Gbps)5 | 支援引擎6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G – 以 Graviton4 為基礎的目前世代記憶體最佳化執行個體類別 R8G 是最新的執行個體系列 (Graviton4)，僅適用於引擎版本 5.0 和 8.0。尚未提供大小 db.r8g.24xlarge 和 db.r8g.48xlarge。 |
| db.r8g.large | 2 | 16 | - | 30 | 0.937 / 12.5 | 5.0.0 和 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1.875 / 12.5 | 5.0.0 和 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3.75 / 15.0 | 5.0.0 和 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7.5 / 15.0 | 5.0.0 和 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 和 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 和 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 和 8.0.0 |
| R6G – 以 Graviton2 為基礎的目前世代記憶體最佳化執行個體類別 |
| db.r6g.large | 2 | 16 | - | 32 | 0.75 / 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1.25 / 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5 / 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0 / 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0、5.0.0 和 8.0.0 |
| R6GD – 以 Graviton2 為基礎的目前世代 NVMe 後端執行個體類別 |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1.25 / 10 | 5.0.0 和 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2.5 / 10 | 5.0.0 和 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5.0 / 10 | 5.0.0 和 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 和 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 和 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 和 8.0.0 |
| R5 – 上一代記憶體最佳化執行個體類別 |
| db.r5.large | 2 | 16 | - | 31 | 0.75 / 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1.25 / 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2.5 / 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0 / 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| R4 – 上一代記憶體最佳化執行個體類別 R4 執行個體僅支援引擎 3.6 版。請注意，Amazon DocumentDB 3.6 已於 2026 年 3 月 30 日終止標準支援。延長支援 （付費） 開放至 2029 年 3 月。 |
| db.r4.large | 2 | 15.25 | - | 30 | 0.75 / 10 | 僅限 3.6.0 |
| db.r4.xlarge | 4 | 30.5 | - | 60 | 1.25 / 10 | 僅限 3.6.0 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5 / 10 | 僅限 3.6.0 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5.0 /10 | 僅限 3.6.0 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 僅限 3.6.0 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 僅限 3.6.0 |
| T4G – 以 Graviton2 為基礎的最新一代爆量效能執行個體類別 T 系列執行個體以無限制 CPU 高載模式執行。超出基準的爆量用量會額外計費。不支援全域叢集。 |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0.256 / 5 | 4.0.0、5.0.0 和 8.0.0 |
| T3 – 上一代爆量效能執行個體類別 |
| db.t3.medium | 2 | 4 | - | 7.5 | 0.256 / 5 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/db-instance-classes.html) |
# NVMe 支援的執行個體
NVMe 後端執行個體為具有大型資料集且超過一般執行個體記憶體的應用程式提供高達 7 倍的更快查詢效能。這些執行個體會利用 r6gd 執行個體上可用的本機非揮發性記憶體表達式 (NVMe) 型固態硬碟 (SSD) 儲存體來存放暫時性資料、減少網路型儲存體存取，以及改善讀取延遲和輸送量。
本機 SSD 空間分為兩個區段：
+ **分層快取** — 大約 73% 的本機 SSD 配置為資料庫快取，允許系統儲存的資料庫頁面比僅主要記憶體多出五倍。本機 SSD 可做為第二層快取，而現有的記憶體內緩衝區快取仍是第一層快取。只有在緩衝區快取和 SSD 快取都發生錯誤時，查詢才會存取外部儲存。
+ **臨時儲存** — 剩餘的 27% 保留給非持久性臨時檔案儲存，用於涉及索引建置等排序或資源密集型操作的複雜查詢。在一般執行個體上，臨時空間位於 Amazon Elastic Block Store (EBS) 磁碟區。SSD 上的本機託管臨時儲存體可降低最多兩次涉及排序的查詢延遲，並加速索引組建等資源密集型操作。
有關支援的 NVMe 後端執行個體類型及其規格的詳細資訊，請參閱 [執行個體類別規格](db-instance-classes.md#db-instance-class-specs)。
**Topics**
+ [NVMe 後端執行個體的建議使用案例](#nvme-use-cases)
+ [搭配 Amazon DocumentDB 使用 NVMe 支援的執行個體](#using-nvme)
+ [監控 NVMe 支援的執行個體](#monitoring-nvme)
## NVMe 後端執行個體的建議使用案例
我們建議您在下列情況下使用 NVMe 支援的執行個體：
+ **高讀取量工作負載**：如果您的工作負載需要大量讀取，且資料集大於緩衝區快取，則 NVMe NVMe 後端執行個體會以低`BufferCacheHitRatio`和高`ReadIOPS`指標表示，可提供效能優勢。
+ **更新密集型工作負載**：如果您的工作負載需要更新，且垃圾收集因為網路儲存上的讀取延遲而無法跟上進度，NVMe 支援的執行個體可能有助於緩解問題。
NVMe 後端執行個體可受益於各種使用案例，包括：
+ **網際網路規模應用程式** — 付款處理、計費和電子商務等具有嚴格效能的服務水準協議 (SLAs) 的應用程式，可以利用 NVMe 後端執行個體的效能優勢。
+ **即時報告儀表板** — 執行數百個指標/資料收集查詢的儀表板，可以受益於 NVMe 後端執行個體的低延遲和高輸送量。
+ **生成式 AI 應用程式** — 使用向量搜尋尋找數百萬個向量內嵌的確切或最接近的鄰里的應用程式，可以利用 NVMe 後端執行個體的高效能。
## 搭配 Amazon DocumentDB 使用 NVMe 支援的執行個體
若要使用 Amazon DocumentDB 的 NVMe 後端執行個體：
+ 建立 Amazon DocumentDB 叢集，並新增其中一個 NVMe 支援的執行個體類別。如需詳細資訊，請參閱[建立 Amazon DocumentDB 叢集](db-cluster-create.md)。
+ 或者，修改現有的 Amazon DocumentDB 叢集，以使用其中一個 NVMe 支援的執行個體類別。如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。
若要檢查不同 AWS 區域中 NVMe 後端執行個體的可用性，請參閱 [各區域的支援執行個體類別](db-instance-classes.md#db-instance-classes-by-region)。
如果您想要從 NVMe 後端執行個體切換回一般執行個體，請將 Amazon DocumentDB 執行個體的資料庫執行個體類別修改為沒有 NVMe 儲存體的類似執行個體類別。例如，如果您目前的執行個體類別是 'db.r6gd.4xlarge'，請選擇 'db.r6g.4xlarge' 來切換回。如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。
## 監控 NVMe 支援的執行個體
除了 Amazon CloudWatch 中可用的一般執行個體指標之外，NVMe 後端執行個體還會發出 NVMe NVMe 型 SSD 儲存體、IOPS 和輸送量特有的其他指標。
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
如需這些指標的詳細資訊，請參閱 [NVMe 支援的執行個體指標](cloud_watch.md#nvme-metrics)