Amazon DocumentDB の使用開始

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

「Amazon DocumentDB クラスターの作成」ページの [クラスタータイプ] セクションで、[インスタンスベースのクラスタ] を選択します (これはデフォルトのオプションです)。

[Configuration] (設定) セクションで次を行います。

1. [クラスター識別子] には、mydocdbcluster などの一意の名称を入力します。コンソール操作では、入力方法に関係なくクラスター名のすべての文字が小文字に変換されることにご留意ください。

2. [エンジンバージョン] で、[5.0.0] を選択します。

3. [インスタンスクラス] で [t3.medium] を選択します。これは AWS 無料利用枠の対象となります。

4. [インスタンスの数] は、[1] を選択します。1 つのインスタンスを選択すると、コストを最小限に抑えることができます。これが本稼働システムの場合は、高可用性のために 3 つのインスタンスをプロビジョニングすることをお勧めします。

[クラスターストレージ設定]セクションでは、[Amazon DocumentDB 標準] (デフォルトのオプションです) を選択します。

[接続]セクションで、以下を設定します。

1. EC2 コンピューティングリソースに接続するを選択します。

2. EC2 インスタンス で、 で作成した EC2 インスタンスを選択します前提条件。

[認証] セクションに、サインイン認証情報を入力します。

他のすべてのオプションはデフォルトのままにして、[クラスターの作成] を選択します。

Amazon DocumentDB マネジメントコンソールで、[クラスター] の下にあるお客様のクラスターを選択します。クラスター識別子をクリックして、作成したクラスターを選択します。

Amazon DocumentDB では、Encryption-in-transit はデフォルトで有効になっています。オプションで TLS を無効にすることができます。クラスターへの認証に必要な現在の証明書をダウンロードするには、[接続とセキュリティ] タブの [接続] セクションで、[クラスターへの認証に必要な Amazon DocumentDB 認証局 (CA) 証明書のダウンロード] で提供される接続文字列をコピーします。Amazon EC2 インスタンスに戻り、 コマンドを貼り付けます。

Amazon DocumentDB コンソールの接続とセキュリティタブの Connect セクションの mongo シェルを使用してこのクラスターに接続する で、提供された接続文字列をコピーしてクラスターに戻ります。<insertYourPassword> のコピーを省略すると、接続時に mongo シェルからパスワードの入力を求められます。

Amazon EC2 インスタンスに戻り、接続文字列を貼り付けます。

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

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

次の出力が返ります。

WriteResult({ "nInserted" : 1 })

findOne() コマンドで書き込んだドキュメントを読み取ることができます (一つのドキュメントしか返さないため)。以下を入力します。

db.collection.findOne()

次の出力が返ります。

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

さらにいくつかのクエリを実行するには、ゲームプロファイルのユースケースを検討してください。まず、「profiles」というタイトルのコレクションにエントリをいくつか挿入します。以下を入力します。

db.profiles.insertMany([
                    { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202},
                    { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9},
                    { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87},
                    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
                    ])

次の出力が返ります。

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

find() コマンドを使用して、プロファイルコレクション内のすべてのドキュメントを返します。以下を入力します。

db.profiles.find()

ステップ 5 で入力したデータに一致する出力が得られます。

フィルターを使用して 1 つのドキュメントに対して1つのクエリを使用します。以下を入力します。

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

この出力を返す必要があります。

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

それでは、プロファイルを探して、それを findAndModify コマンドで変更してみましょう。次のコードを使用して、ユーザー Matt に10 ポイント追加します。

db.profiles.findAndModify({
                query: { name: "Matt", status: "active"},
                update: { $inc: { score: 10 } }
            })

次のような出力が得られます (Mattのスコアはまだ上がっていないことに注意してください) 。

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

次のクエリを使用して、Matt のスコアが変更されたことを確認できます。

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

次の出力が返ります。

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