1.1 – AWS マネジメントコンソールを使用して、AWS Cloud9 マネジメントコンソールで、[環境を作成] を選択します。

1.2 – DocumentDBCloud9 という名前を入力します。

1.3 – [次のステップ] をクリックします。

1.4 – [設定の構成] セクションで、すべてのデフォルトを承認します。

1.5 – [次のステップ] をクリックします。

1.6 – [レビュー] セクションで、[環境を作成] を選択します。

1.7 – AWS Cloud9 環境のプロビジョニングには、最大 3 分かかります。

2.1 – Amazon EC2 マネジメントコンソールの [ネットワークとセキュリティー] で、[セキュリティグループ] を選択します。

2.2 – [セキュリティグループを作成] をクリックします。

2.3 – [セキュリティグループ名] に、demoDocDB と入力します。

2.4 – [説明] に説明を入力します。

2.5 – [VPC] に、デフォルト VPC の使用を承認します。

2.6 – [受信ルール] セクションで、[ルールを追加] を選択します。

2.7 – [タイプ] に [カスタム TCP ルール] を選択します。

2.8 – [ポート範囲] に「27017」と入力します。

2.9 – ソースセキュリティグループは、作成した AWS Cloud9 環境のセキュリティグループです。ソースをカスタムのデフォルト値のままにし、カスタムの横にあるフィールドに「cloud9」と入力して、使用可能なセキュリティグループのリストを表示します。

2.10 – aws-cloud9- <環境名> という名前のセキュリティグループを選択します。

2.11 – 他のすべてのデフォルトを承認し、[セキュリティグループを作成] を選択します。送信ルールを変更する必要はありません。

3.1 – Amazon DocumentDB マネジメントコンソールの [クラスター] で、[作成] を選択します。

3.2 – [Amazon DocumentDB クラスターの作成] ページで、[インスタンスクラス] の下にある [db.t3.medium] を選択し、[インスタンス数] で 1 を選択します。これらのオプションで、費用を最小限に抑えることができます。

3.3 – 他の設定はデフォルトのままにします。

3.4 – [認証] セクションで、ユーザー名とパスワードを入力します。

3.5 – [詳細設定を表示] をオンにします。

3.6 – [ネットワーク設定] セクションの [VPC セキュリティグループ] で、[demoDocDB] を選択します。

3.7 – [クラスターを作成] を選択します。

4.1 – AWS Cloud9 環境がまだ開いている場合は、ステップ 3 にスキップできます。

4.2 – AWS Cloud9 マネジメントコンソールの [使用環境] で、[DocumentDBCloud9] を選択します。

4.3 – [IDE を開く] を選択します。

4.4 – コマンドプロンプトで、次のコードを使用してリポジトリファイルを作成します。

echo -e "[mongodb-org-3.6] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/3.6/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc" | sudo tee /etc/yum.repos.d/mongodb-org-3.6.repo

4.5 – 完了したら、次のコードを使用して mongo シェルをインストールします。

sudo yum install -y mongodb-org-shell

4.6 – 送信中のデータを暗号化するには、Amazon DocumentDB の CA 証明書をダウンロードします。以下のコードをご覧ください。

wget https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem

4.7 – これで、Amazon DocumentDB クラスターに接続する準備ができました。

5.1 – Amazon DocumentDB マネジメントコンソールの [クラスター] で、クラスターを見つけます。この投稿では、クラスター docdb-2020-02-08-14-15-11 を使用します。

5.2 – クラスター識別子 (この例では docdb-2020-02-08-14-15-11) をクリックして、作成したクラスターを選択します。

5.3 – 「mongo シェルでこのクラスターに接続する」で提供されている接続文字列をコピーします。

<insertYourPassword> を省略して、接続時に mongo シェルによってパスワードの入力を求められるようにします。これにより、パスワードをクリアテキストで入力を行う必要がなくなります。

5.4 – 接続文字列は次のコードのようになります (スクリーンショットを参照)。

5.5 – パスワードを入力して rs0:PRIMARY> プロンプトが表示されると、Amazon DocumentDB クラスターに正常に接続されているということです。

トラブルシューティングについては、Amazon DocumentDB のトラブルシューティングを参照してください。

6.1 - これでクラスターに接続されたので、ドキュメントデータベースの使用に慣れるためにいくつかのクエリを実行できます。

ドキュメントを 1 つ挿入するには、次のコードを入力します。

db.collection.insert({"hello":"DocumentDB"})

以下の出力が表示されます。

WriteResult({ "nInserted" : 1 })

6.2 - 作成したドキュメントでは 1 つのドキュメントしか返されないため、findOne() コマンドで読み取ることができます。以下のコードをご覧ください。

db.collection.findOne()

以下の出力が表示されます。

{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

6.3 - いくつかのクエリを追加で実行するには、ゲームプロファイルの使用例を検討してください。まず、プロファイルというタイトルのコレクションにいくつかのエントリを挿入します。以下のコードをご覧ください。

db.profiles.insertMany([

{ "_id" : 1, "name" : "Tim", "status": "active", "level": 12, "score":202},

{ "_id" : 2, "name" : "Justin", "status": "inactive", "level": 2, "score":9},

{ "_id" : 3, "name" : "Beth", "status": "active", "level": 7, "score":87},

{ "_id" : 4, "name" : "Jesse", "status": "active", "level": 3, "score":27}

])

以下の出力が表示されます。

{ "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

6.4 - find() コマンドを使用して、プロファイルコレクション内のすべてのドキュメントを返します。以下のコードをご覧ください。

db.profiles.find()

以下の出力が表示されます。

{ "_id" : 1, "name" : "Tim", "status" : "active", "level" : 12, "score" : 202 }

{ "_id" : 2, "name" : "Justin", "status" : "inactive", "level" : 2, "score" : 9 }

{ "_id" : 3, "name" : "Beth", "status" : "active", "level" : 7, "score" : 87 }

{ "_id" : 4, "name" : "Jesse", "status" : "active", "level" : 3,

6.5 - フィルターを使用して 1 つのドキュメントのクエリを使用します。以下のコードをご覧ください。

db.profiles.find({name: "Jesse"})

以下の出力が表示されます。

{ "_id" : 4, "name" : "Jesse", "status" : "active", "level" : 3, "score" : 27 }

6.6 - ゲームの一般的な使用例では、指定ユーザーのプロファイルを見つけて、ユーザーのプロファイルの値を増分します。このシナリオでは、上位のアクティブなゲーマーに対してプロモーションを実行します。ゲーマーがアンケートに応答すると、スコアが +10 増加します。

そのためには、findAndModify コマンドを使用します。この使用例では、ユーザー Tim がアンケートを完了しました。Tim にスコアのクレジットを付与するには、次のコードを入力します。

db.profiles.findAndModify({

   query: { name: "Tim", status: "active"},

   update: { $inc: { score: 10 } }

})

以下の出力が表示されます。

{

      "_id" : 1,

      "name" : "Tim",

      "status" : "active",

      "level" : 12,

      "score" : 202

}

6.7 - 次のクエリで結果を確認できます。

db.profiles.find({name: "Tim"})

以下の出力が表示されます。

{ "_id" : 1, "name" : "Tim", "status" : "active", "level" : 12, "score" : 212 }