翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ツールキットでの Amazon DocumentDB の使用
<a name="docdb-overview"></a>

Amazon DocumentDB (MongoDB 互換) は、MongoDB と互換性のあるデータベースをクラウド上で簡単にセットアップ、操作、スケーリングできる、高速で信頼性の高い完全マネージドデータベースサービスです。

Amazon DocumentDB、開始方法、チュートリアルの詳細については、「[Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html) デベロッパーガイド」を参照してください。

次のセクションでは、 AWS Toolkit for Visual Studio Codeで Amazon DocumentDB を使用する方法について説明します。

## AWS Toolkit から Amazon DocumentDB にアクセスする
<a name="docdb-overview-access"></a>

 AWS Toolkit を使用して Amazon DocumentDB にアクセスするには、次の手順を実行します。

**AWS Toolkit での Amazon DocumentDB へのアクセス**

1. VS Code から を開きます AWS Toolkit for Visual Studio Code。

1. Toolkit から AWS Explorer ****を展開します。

1. **[エクスプローラー]** から Amazon DocumentDB を展開し、既存の Amazon DocumentDB リソースを表示します。

## インスタンスベースのクラスターの作成
<a name="docdb-overview-create-cluster"></a>

Amazon DocumentDB の使用を開始するには、次の手順を実行してクラスターを作成します。

**インスタンスベースのクラスターの作成**

1. から AWS Toolkit for Visual Studio Code、Amazon DocumentDB のコンテキストメニューを開き (右クリック）、**クラスターの作成を選択して** VS Code で ** Amazon DocumentDB クラスターの作成**ダイアログを開きます。

1. **[クラスタータイプ]** 画面で **[インスタンスベースのクラスター]** を選択します。

1. **[クラスター名]** 画面で、新しいクラスターの名前を指定します。

1. **[エンジンバージョンの選択]** 画面で、任意の Amazon DocumentDB エンジンバージョンを選択します。

1. **[管理者のユーザー名とパスワード]** 画面で、クラスターを保護する管理者のユーザー名とパスワードを指定します。

1. **[ストレージ暗号化の指定]** 画面で、クラスターを暗号化するかどうかを選択します。

1. **[インスタンス数]** 画面で、任意のインスタンス数を設定します。

1. **[インスタンスクラスの選択]** 画面で、任意のインスタンスクラスを選択し、新しいクラスターの作成に進みます。
**注記**  
クラスターの作成には数分かかる場合があります。

## クラスターエンドポイントのコピー
<a name="docdb-overview-create-cluster"></a>

Amazon DocumentDB クラスターエンドポイントをコピーするには、次の手順を実行します。

**クラスターエンドポイントのコピー**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. 接続の詳細をコピーするクラスターを右クリックし、**[エンドポイントのコピー]** を選択してクラスターエンドポイント情報をクリップボードにコピーします。

1. これで、クラスターのエンドポイントをドキュメントに貼り付けることができます。

## ブラウザで開く
<a name="docdb-overview-browser-cluster"></a>

 AWS コンソールで Amazon DocumentDB クラスターを開き、クラスター管理機能を強化します。 AWS コンソールをデフォルトのウェブブラウザで Amazon DocumentDB クラスターに開くには、次の手順を実行します。

**AWS コンソールでクラスターを開く**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1.  AWS コンソールで表示するクラスターを右クリックし、**ブラウザで開く**を選択します。

1.  AWS コンソールがデフォルトのウェブブラウザで Amazon DocumentDB クラスターに開きます。

## 既存のクラスターの拡張
<a name="docdb-overview-expand-cluster"></a>

インスタンスを追加して Amazon DocumentDB クラスターをスケールするには、次の手順を実行します。

**インスタンスを追加してクラスターを拡張する**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. 展開したいクラスターを右クリックし、**[インスタンスを追加する]** を選択して、VS Code で**Add an Instance** ダイアログを開きます。

1. プロンプトが表示されたら、新しいインスタンスの名前をテキストフィールドに入力し、 **Enter** キーを押して続行します。

1. プロンプトが表示されたら、リストからインスタンスクラスを選択して続行します。

1. **AWS エクスプローラー**に作成ステータスが表示され、新しいインスタンスの準備ができたら更新されます。

## クラスターの停止
<a name="docdb-overview-stopping-cluster"></a>

Amazon DocumentDB クラスターを停止するには、次の手順を実行します。

**注記**  
クラスターが停止している間、ほとんどのクラスター管理機能は使用できなくなります。

**Amazon DocumentDB クラスターの停止**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. クラスターの横にある **[クラスターの停止]** ボタンを選択するか、クラスターを右クリックして **[クラスターの停止]** を選択します。

1. プロンプトが表示されたら、**[はい]** を選択してクラスターを停止するか、**[キャンセル]** を選択して停止プロセスをキャンセルし、クラスターを実行したままにします。

1. **AWS エクスプローラー** にはクラスターのステータスが表示され、クラスターが停止すると更新されます。

## インスタンスの再起動
<a name="docdb-overview-reboot-cluster"></a>

インスタンスの再起動は、クラスター全体に影響を与えることなくトラブルシューティングや軽微な変更を行うのに便利です。Amazon DocumentDB インスタンスを再起動するには、次の手順を実行します。

**クラスターインスタンスの再起動**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. 再起動するクラスターインスタンスを右クリックし、**[インスタンスを再起動]** を選択します。

1. プロンプトが表示されたら、**[はい]** を選択してインスタンスを再起動するか、**[キャンセル]** を選択して再起動プロセスをキャンセルし、インスタンスを停止したままにします。

1. **AWS エクスプローラー** にはクラスターのステータスが表示され、インスタンスが再起動されると更新されます。

## インスタンスの削除
<a name="docdb-overview-delete-cluster"></a>

Amazon DocumentDB クラスターインスタンスを削除するには、次の手順を実行します。

**注記**  
インスタンスを削除しても、クラスター内のデータには影響しません。プライマリインスタンスを削除すると、レプリカインスタンスの 1 つが書き込み可能なインスタンスとして引き継がれます。

**クラスターインスタンスの削除**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. 削除するクラスターインスタンスを右クリックし、**[削除]** を選択して VS Code で delete-cluster-instance 確認ダイアログを開きます。

1. 確認プロンプトに従い、**Enter** キーを押してクラスターインスタンスを削除します。

1. **AWS エクスプローラー** はクラスターインスタンスのステータスを表示し、インスタンスが削除されると更新されます。

## タグの表示、追加、削除
<a name="docdb-overview-tags"></a>

タグは、環境内のリソースを整理および追跡するために使用されます。Amazon DocumentDB クラスターに関連付けられたタグを表示または編集するには、次のいずれかの手順を実行します。

**クラスタータグの表示**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. タグを表示するクラスターを右クリックし、**[タグ...]** を選択して [****your cluster name** のタグ**] ダイアログを開きます。

1. タグがダイアログウィンドウに表示されます。タグがクラスターに関連付けられていない場合は、**[タグが割り当てられていません]** というメッセージが表示されます。

**クラスターへのタグの追加**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. タグを追加するクラスターを右クリックし、**[タグ...]** を選択して [****your cluster name** のタグ**] ダイアログを開きます。

1. **[タグの追加...]** ボタンを選択して、VS Code で**Add Tag** ダイアログを開きます。

1. テキストフィールドに新しいタグを入力し、**Enter** キーを押して続行します。

1. テキストフィールドに値を入力し、**Enter** キーを押してキーと値のペアをクラスターに追加します。

**クラスターからのタグの削除**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. タグを削除するクラスターを右クリックし、**[タグ...]** を選択して **[**your cluster name** のタグ]** ダイアログを開きます。

1. **[タグの削除...]** ボタンを選択して、VS Code の **Remove a tag from **your cluster name**** ダイアログを開きます。

1. 表示されるリストから削除するタグを選択して、クラスターからタグを削除します。

## インスタンスクラスの変更
<a name="docdb-overview-instance-class"></a>

Amazon DocumentDB クラスターインスタンスのクラスを変更するには、次の手順を実行します。

**インスタンスクラスの変更**

1. から AWS Toolkit for Visual Studio Code、**Amazon DocumentDB** を展開して Amazon DocumentDB クラスターを表示します。

1. 変更するクラスターインスタンスを右クリックし、**[クラスの変更...]** を選択して、VS Code で **Select instance class** ダイアログを開きます。

1. リストからインスタンスの新しいクラスを選択して、クラスを更新します。

1. **AWS エクスプローラー** はクラスターインスタンスのステータスを表示し、インスタンスが変更されると更新されます。