翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB インスタンスの管理
以下のトピックでは、Amazon DocumentDB インスタンスの管理に役立つ情報を提供します。インスタンスクラスとステータスの詳細、およびインスタンスを作成、削除、変更する方法が含まれます。
**Topics**
+ [インスタンスのステータスの判断](#db-instance-status)
+ [インスタンスのライフサイクル](db-instance-life-cycle.md)
+ [インスタンスクラスの管理](db-instance-classes.md)
+ [NVMe-backed インスタンス](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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. インスタンスの追加先のクラスターを選択するには、クラスター名の左にあるボタンを選択します。
1. [**アクション**] を選択し、[**インスタンスの追加**] を選択します。
1. [**Add instance to: (インスタンスの追加先:)**] ページで、クラスターに追加する各インスタンスに対して以下の手順を繰り返します。最大数は 15 です。
1. **インスタンス識別子** - このインスタンスの一意の識別子を入力するか、クラスター識別子に基づき Amazon DocumentDB でインスタンスを指定できるようにします。
インスタンスの名前付けの制約:
+ 長さは [1 〜 63] 個の英字、数字、またはハイフンです。
+ 1 字目は英字である必要があります。
+ ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
+ Amazon RDS、Neptune、Amazon DocumentDB のすべてのインスタンスで AWS アカウント、リージョンごとに一意である必要があります。
1. **インスタンスクラス** - ドロップダウンリストから、このインスタンスに必要なインスタンスタイプを選択します。
1. **プロモーション枠** - ドロップダウンリストからインスタンスのプロモーション枠を選択するか、[*指定なし*] を選択して Amazon DocumentDB によってインスタンスのプロモーション枠が設定されるようにします。数値が小さいほど優先順位が高くなります。詳細については、「[フェイルオーバーターゲットの制御](failover.md#failover-target_control)」を参照してください。
1. インスタンスをさらに追加するには、[**Add additional instances (追加のインスタンスを追加する)**] を選択してステップ a、b、c を繰り返します。
1. オペレーションを完了します。
+ インスタンスをクラスターに追加するには、[**作成**] を選択します。
+ 操作をキャンセルするには、[**キャンセル**] を選択します。
インスタンスが作成されるまでに数分かかります。コンソールまたは を使用して 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] 個の英字、数字、またはハイフンです。
+ 1 字目は英字である必要があります。
+ ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
+ 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 を使用して、接続エンドポイント、セキュリティグループ VPC、認証機関、Amazon DocumentDB インスタンスに関連するパラメータグループなどの詳細を確認できます。
------
#### [ Using the AWS マネジメントコンソール ]
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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. インスタンスの一覧で、詳細を表示したいインスタンスの名前を選択します。インスタンスに関する情報は、次のグループに分けられます。
+ **概要** エンジンのバージョン、クラス、ステータス、保留中のメンテナンスなど、インスタンスに関する一般情報。
+ **Connectivity & Security** - **Connect** セクションには、[mongo] シェルまたはアプリケーションを使用してこのインスタンスに接続するための接続エンドポイントが一覧表示されます。[**セキュリティグループ**] セクションには、このインスタンスに関連付けられているセキュリティグループと、その VPC ID や説明が一覧表示されます。
+ **設定** - [**詳細**] セクションには、インスタンスの Amazon リソースネーム (ARN)、エンドポイント、ロール、クラス、認証機関など、インスタンスの設定とステータスが一覧表示されます。また、インスタンスのセキュリティとネットワーク設定、バックアップ情報も一覧表示されます。[**クラスターの詳細**] セクションには、このインスタンスが属するクラスターの詳細が表示されます。[**クラスターのインスタンス**] セクションには、クラスターに属するすべてのインスタンスが、各インスタンスのロールとクラスターパラメータグループのステータスとともに一覧表示されます。
**注記**
**クラスターの詳細** ヘッダーの次に **Modify** を選択することにより、インスタンスに関連付けられているクラスターを変更できます。詳細については、「[Amazon DocumentDB クラスターの変更](db-cluster-modify.md)」を参照してください。
+ [**モニタリング**] — このクラスターの Amazon CloudWatch Logs メトリクス。詳細については、「[Amazon DocumentDB と CloudWatch のモニタリング](cloud_watch.md)」を参照してください。
+ [**イベントとタグ**] — [**最近のイベント**] セクションには、このインスタンスの最近のイベントの一覧が表示されます。Amazon DocumentDB は、クラスター、インスタンス、スナップショット、セキュリティグループ、およびクラスターパラメータグループに関連するイベントのレコードを保持します。この情報には、各イベントに関連する日付、時刻、およびメッセージが含まれます。[**タグ**] セクションには、このクラスターにアタッチされているタグが一覧表示されます。詳細については、「[Amazon DocumentDB リソースへのタグ付け](tagging.md)」を参照してください。
------
#### [ Using the AWS CLI ]
を使用して Amazon DocumentDB インスタンスの詳細を表示するには AWS CLI、以下の例に示すように `describe-db-clusters` コマンドを使用します。詳細については、「*Amazon DocumentDB リソース管理 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. **List all Amazon DocumentDB instances.**
次の 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 インスタンスの変更
Amazon DocumentDB インスタンスは、 AWS マネジメントコンソール または を使用して変更できます AWS CLI。インスタンスを変更するには、インスタンスが *使用可能* 状態である必要があります。停止しているインスタンスを変更することはできません。クラスターが停止している場合は、最初にクラスターを起動し、インスタンスが*使用可能*になるまで待ってから、必要な変更を加えます。詳細については、「[Amazon DocumentDB クラスターの停止と開始](db-cluster-stop-start.md)」を参照してください。
------
#### [ 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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. 変更するインスタンスの左側にあるボックスをチェックします。
1. [**アクション**] を選択してから、[**変更**] を選択します。
1. [**インスタンスの変更: **] ペインで、必要な変更を行います。以下の変更を行うことができます。
+ **インスタンス仕様** - インスタンス識別子とクラス。インスタンス識別子の命名制約:
+ **インスタンス識別子** — 現在のリージョンで が所有するすべてのインスタンス AWS アカウント に一意の名前を入力します。インスタンス識別子は [1 — 63] 英数字またはハイフンを使用し、最初の文字に文字を使用します。最後の文字をハイフンにすることはできず、ハイフンを 2 つ続けて使用することもできません。
+ **インスタンスクラス** — ドロップダウンメニューから、Amazon DocumentDB インスタンスのためのインスタンスクラスを選択します。詳細については、「[インスタンスクラスの管理](db-instance-classes.md)」を参照してください。
+ **認証機関** - このインスタンスのサーバー証明書。詳細については、「[Amazon DocumentDB TLS 証明書の更新](ca_cert_rotation.md)」を参照してください。
+ **フェイルオーバー** - フェイルオーバーにより、昇格階層が最も高いインスタンスがプライマリに昇格されます 詳細については、「[Amazon DocumentDB フェイルオーバー](failover.md)」を参照してください。
+ **メンテナンス** - 保留中の変更またはパッチをクラスター内のインスタンスに適用するメンテナンスウィンドウ。
1. 完了したら、[**続行**] を選択して変更の概要を表示します。
1. 変更を確認したら、直ちに、あるいは、[**変更のスケジューリング**] の下にある次のメンテナンスウィンドウ中に適用することができます。[**インスタンスの変更**] を選択して、変更を保存します。または、[**キャンセル**] を選択して変更を破棄することもできます。
変更が適用されるまでに数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは 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` に変更します。
**パラメータ**
+ **--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"
]
}
]
}
```
変更が適用されるまでに数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。インスタンスのステータスは、 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)」を参照してください。
*available (利用可能)* 状態でないインスタンスを再起動することはできません。データベースは、以前の要求による変更、またはメンテナンスウィンドウのアクションなど、いくつかの理由で使用できない場合があります。インスタンスステータスの詳細については、「[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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. 再起動するインスタンスの左側にあるボックスをチェックします。
1. [**Actions (アクション)**]、[**Reboot (再起動)**] の順に選択し、[**Reboot (再起動)**] を選択して再起動を確認します。
インスタンスが再起動するまでには数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは 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"
]
}
}
```
インスタンスが再起動するまでには数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは AWS CLIを使用して、インスタンスのステータスをモニタリングできます。詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
# Amazon DocumentDB インスタンスの削除
Amazon DocumentDB インスタンスは、 AWS マネジメントコンソール または を使用して削除できます AWS CLI。インスタンスを削除するには、インスタンスが *使用可能* 状態である必要があります。停止しているインスタンスを削除することはできません。インスタンスを含む Amazon DocumentDB クラスターが停止している場合は、最初にクラスターを起動し、インスタンスが *使用可能* になるまで待ってから、インスタンスを削除します。詳細については、「[Amazon DocumentDB クラスターの停止と開始](db-cluster-stop-start.md)」を参照してください。
**注記**
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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. 削除するインスタンスの左側にあるボックスをチェックします。
1. [**Actions (アクション)**] を選択して、[**Delete (削除)**] を選択します。
1. クラスターの最後のインスタンスを削除する場合:
+ **Create final cluster snapshot? (最終クラスタースナップショットを作成しますか?)** - クラスターを削除する前に最終スナップショットを作成する場合は、[**はい**] を選択します。それ以外の場合は [**いいえ**] を選択します。
+ **Final snapshot name (最終スナップショット名)** - 最終スナップショットを作成する場合は、作成した新しいクラスタースナップショットのクラスタースナップショットの識別子を入力します。
+ **Delete instance? ( インスタンスを削除しますか?)** - 削除を確定するには、[**delete entire cluster (クラスター全体を削除)**] というフレーズをフィールドに入力します。
1. クラスターの最後のインスタンスを削除しない場合:
+ **Delete instance? ( インスタンスを削除しますか?)** - 削除を確認するフレーズ [**delete me (これを削除する)**] をフィールドに入力します。
1. [**Delete (削除)**] を選択して、インスタンスを削除します。
インスタンスが削除されるまでに数分かかります。インスタンスのステータスをモニタリングするには、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
#### [ Using the AWS CLI ]
次の手順では、 AWS CLIを使用して Amazon DocumentDB インスタンスを削除します。
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 クラスターの最後のインスタンスを削除すると、クラスターと、そのクラスターに関連付けられた自動スナップショットと継続バックアップも削除されます。Amazon DocumentDB は、 AWS マネジメントコンソール または を使用して削除オペレーションを実行するかどうかにかかわらず、クラスターの削除保護を適用します 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://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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスターの下にネストされる方法を示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. インスタンスの一覧で、クラスターを展開して、関心のあるインスタンスを見つけます。目的のインスタンスを見つけます。次に、インスタンスの行の **Size (サイズ)** 列を確認し、インスタンスクラスを参照します。
次の図では、インスタンス `robo3t` のインスタンスクラスは `db.r5.4xlarge` です。
![\[インスタンスタイプを示すサイズ列があるクラスターテーブル内のインスタンスのリスト。\]](http://docs.aws.amazon.com/ja_jp/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`— R6G インスタンスと比較してパフォーマンスが最大 30% 向上する Arm ベースの AWS Graviton4 プロセッサを搭載したメモリ最適化インスタンスの最新世代。
+ `R6G`— Arm ベースの AWS Graviton2 プロセッサを搭載したメモリ最適化インスタンス。R5 インスタンスよりも最大 30% 優れたパフォーマンスを提供し、コストを 5% 削減します。
+ `R6GD` — エフェメラルデータ用のローカル不揮発性メモリエクスプレス (NVMe) ベースのソリッドステートドライブ (SSD) ストレージを備えたメモリ最適化 R6G インスタンス。
+ `R5` - 同じインスタンスコストでR4インスタンスよりも最大 100％ 優れたパフォーマンスを提供するメモリ最適化インスタンス。
+ `R4` - 前世代のメモリ最適化インスタンス。
+ `T4G`—ベースラインレベルの CPU パフォーマンスを提供する Arm ベースの AWS Graviton2 プロセッサを搭載した最新世代の低コストのバースト可能な汎用インスタンスタイプ。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 | サーバーレス |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 米国東部 (オハイオ) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート |
| 米国東部 (バージニア北部) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート |
| 米国西部 (オレゴン) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート |
| アフリカ (ケープタウン) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| 南米 (サンパウロ) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (香港) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (ハイデラバード) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (マレーシア) | | | サポート対象 | | | サポート対象 | サポート | |
| アジアパシフィック (ムンバイ) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (大阪) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート | |
| アジアパシフィック (ソウル) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (シドニー) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| アジアパシフィック (ジャカルタ) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート | |
| アジアパシフィック (メルボルン) | | | サポート対象 | サポート対象 | | サポート対象 | サポート | |
| アジアパシフィック (シンガポール) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| アジアパシフィック (タイ) | | | サポート対象 | | | サポート対象 | サポート対象 | |
| アジアパシフィック (東京) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| カナダ (中部) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (フランクフルト) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| 欧州 (チューリッヒ) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | |
| 欧州 (アイルランド) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (ロンドン) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (ミラノ) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (パリ) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (スペイン) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 欧州 (ストックホルム) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | |
| メキシコ (中部) | | | サポート対象 | | | サポート対象 | サポート対象 | |
| 中東 (アラブ首長国連邦) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 中国 (北京) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| 中国 (寧夏) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
| イスラエル (テルアビブ) | | | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| AWS GovCloud (米国西部) | サポート対象 | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート |
| AWS GovCloud (米国東部) | | サポート対象 | サポート対象 | サポート対象 | | サポート対象 | サポート対象 | サポート対象 |
## インスタンスクラスの仕様
次の表は、各クラスでサポートされているインスタンスタイプなど、Amazon DocumentDB インスタンスクラスの詳細を示しています。各テーブル列の説明については、表の下部を参照してください。
| インスタンスクラス | vCPU1 | メモリ (GiB)2 | NVMe SSD 階層型キャッシュ (GiB)3 | 最大一時ストレージ (GiB)4 | ベースライン/バースト帯域幅 (Gbps)5 | 使用エンジン6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G – Graviton4 に基づく現行世代のメモリ最適化インスタンスクラス R8G は、エンジンバージョン 5.0 および 8.0 でのみ利用可能な最新のインスタンスファミリー (Graviton4) です。サイズ 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 – Current Generation Memory-Optimized Instance Class based on 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 – Current Generation NVMe-backed Instance Class based on Graviton2 |
| 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 – Latest Generation Burstable Performance Instance Classes based on 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/ja_jp/documentdb/latest/developerguide/db-instance-classes.html) |
# NVMe-backed インスタンス
NVMe-backed インスタンスは、通常のインスタンスのメモリを超える大規模なデータセットを持つアプリケーションに対して、クエリパフォーマンスを最大 7 倍高速化します。これらのインスタンスは、r6gd インスタンスで利用可能なローカル不揮発性メモリエクスプレス (NVMe) ベースのソリッドステートドライブ (SSD) ストレージを活用してエフェメラルデータを保存し、ネットワークベースのストレージアクセスを減らし、読み取りレイテンシーとスループットを向上させます。
ローカル SSD スペースは 2 つのセクションに分かれています。
+ **階層型キャッシュ** — ローカル SSD の約 73% がデータベースキャッシュとして割り当てられるため、システムはメインメモリのみの最大 5 倍のデータベースページを保存できます。ローカル SSD は第 2 層のキャッシュとして機能し、既存のメモリ内バッファキャッシュは第 1 層のキャッシュのままです。クエリは、バッファキャッシュと SSD キャッシュの両方にミスがある場合にのみ外部ストレージにアクセスします。
+ **一時ストレージ** — 残りの 27% は非永続的な一時ファイルストレージ用に予約されており、ソートやインデックスビルドなどのリソース集約型オペレーションを含む複雑なクエリに使用されます。通常のインスタンスでは、一時スペースは Amazon Elastic Block Store (EBS) ボリュームにあります。SSD 上のローカルにホストされた一時ストレージは、ソートを含むクエリのレイテンシーを最大 2 倍削減し、インデックスビルドなどのリソース集約型のオペレーションを高速化します。
サポートされる NVMe-backed インスタンスのタイプとその仕様の詳細については、「[インスタンスクラスの仕様](db-instance-classes.md#db-instance-class-specs)」を参照してください。
**Topics**
+ [NVMe-backed インスタンスの推奨ユースケース](#nvme-use-cases)
+ [Amazon DocumentDB での NVMe-backed インスタンスの使用](#using-nvme)
+ [NVMe-backed インスタンスのモニタリング](#monitoring-nvme)
## NVMe-backed インスタンスの推奨ユースケース
次のシナリオでは、NVMe-backed インスタンスを使用することをお勧めします。
+ **読み取り負荷の高いワークロード** — ワークロードの読み取り負荷が高く、データセットがバッファキャッシュよりも大きく、低い `BufferCacheHitRatio` と高い `ReadIOPS` メトリクスが示された場合、NVMe-backed インスタンスはパフォーマンス上の利点を提供します。
+ **更新負荷の高いワークロード** — ワークロードの更新負荷が高く、ネットワークストレージの読み取りレイテンシーが原因でガベージコレクションが遅れずに対応することができない場合、NVMe-backed インスタンスは問題を軽減するのに役立ちます。
NVMe-backed インスタンスは、次のようなさまざまなユースケースにメリットがあります。
+ **インターネットスケールアプリケーション** — 厳格なパフォーマンスのサービスレベルアグリーメント (SLAs) による支払い処理、請求、e コマースなどのアプリケーションは、NVMe-backed インスタンスのパフォーマンス上の利点を活用できます。
+ **リアルタイムレポートダッシュボード** — メトリクス/データ収集のために数百のクエリを実行するダッシュボードは、NVMe-backed インスタンスの低レイテンシーと高スループットのメリットが得られます。
+ **生成 AI アプリケーション** — ベクトル検索を使用して数百万のベクトル埋め込みの完全または最近傍を検索するアプリケーションは、NVMe-backed インスタンスの高性能を活用できます。
## Amazon DocumentDB での NVMe-backed インスタンスの使用
Amazon DocumentDB の NVMe-backed インスタンスを使用するには:
+ Amazon DocumentDB クラスターを作成し、NVMe-backed インスタンスクラスのいずれかを追加します。詳細については、「[Amazon DocumentDB クラスターの作成](db-cluster-create.md)」を参照してください。
+ または、NVMe-backed インスタンスクラスのいずれかを使用するように既存の Amazon DocumentDB クラスターを変更します。詳細については、「[Amazon DocumentDB クラスターの変更](db-cluster-modify.md)」を参照してください。
さまざまな AWS リージョンで NVMe-backed インスタンスの可用性を確認するには、「[リージョン別のサポートされるインスタンスクラス](db-instance-classes.md#db-instance-classes-by-region)」を参照してください。
NVMe-backed インスタンスから通常のインスタンスに切り替える場合は、Amazon DocumentDB インスタンスのデータベースインスタンスクラスを、NVMe ストレージを使用せずに同様のインスタンスクラスに変更します。例えば、現在のインスタンスクラスが「db.r6gd.4xlarge」の場合、「db.r6g.4xlarge」を選択して元に戻します。詳細については、「[Amazon DocumentDB クラスターの変更](db-cluster-modify.md)」を参照してください。
## NVMe-backed インスタンスのモニタリング
Amazon CloudWatch で使用可能な通常のインスタンスメトリクスに加えて、NVMe-backed インスタンスは、NVMe ベースの SSD ストレージ、IOPS、スループットに固有の追加のメトリクスを出力します。
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
これらのメトリクスの詳細については、「[NVMe-backed インスタンスメトリクス](cloud_watch.md#nvme-metrics)」を参照してください