Get started with Amazon DocumentDB

Sign in to the AWS Management Console, and open the Amazon DocumentDB console at https://console.aws.amazon.com/docdb.

On the Amazon DocumentDB management console, under Clusters, choose Create.

On the Create Amazon DocumentDB cluster page, in the Cluster type section, choose Instance-based cluster (this is the default option).

In the Cluster configuration section:

1. For Cluster identifier, enter a unique name, such as mydocdbcluster. Note that the console will change all cluster names into lower-case regardless of how they are entered.

2. For Engine version, choose 5.0.0.

In the Cluster storage configuration section, choose Amazon DocumentDB Standard (this is the default option).

In the Instance configuration section:

1. For DB instance class, choose Memory optimized classes (include r classes) (this is default).

   The other instance option is NVMe-backed classes. To learn more, see NVMe-backed instances.

2. For Instance class, choose db.t3.medium. This is eligible for the AWS free trial.

3. For Number of instances, choose 1 instance. Choosing one instance helps minimize costs. If this were a production system, we would recommend that you provision three instances for high availability.

In the Connectivity section, leave the default setting of Don't connect to an EC2 compute resource.

In the Authentication section, enter a username for the primary user, and then choose Self managed. Enter a password, then confirm it.

If you instead chose Managed in AWS Secrets Manager, see Password management with Amazon DocumentDB and AWS Secrets Manager for more information.

Leave all other options as default and choose Create cluster.

On the Amazon DocumentDB management console, under Clusters, locate the cluster you created. Choose your cluster by clicking the check box next to it.

Click Connect to cluster (which is next to the Actions dropdown menu). This button is enabled only after you have clicked the checkbox next to your cluster, and the status of both the regional cluster and primary instance(s) show as Available. The CloudShell Run command screen appears.

In the New environment name field, enter a unique name, such as "test" and click Create and run. VPC environment details are automatically configured for your Amazon DocumentDB database.

When prompted, enter the password you created in Step 1: Create an Amazon DocumentDB cluster (sub-step 7).

After you enter your password and your prompt becomes rs0 [direct: primary] <env-name>>, you are successfully connected to your Amazon DocumentDB cluster.

To insert a single document, enter the following:

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

You get the following output:

{
  acknowledged: true,
  insertedId: ObjectId('673657216bdf6258466b128c')
}

You can read the document that you wrote with the findOne() command (because it only returns a single document). Input the following:

db.collection.findOne()

You get the following output:

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

To perform a few more queries, consider a gaming profiles use case. First, insert a few entries into a collection titled profiles. Input the following:

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 }]
])

You get the following output:

{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }

Use the find() command to return all the documents in the profiles collection. Input the following:

db.profiles.find()

You will get an output that will match the data you typed in Step 3.

Use a query for a single document using a filter. Input the following:

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

You get the following output:

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

Now let’s try to find a profile and modify it using the findAndModify command. We’ll give the user Matt an extra 10 points with the following code:

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

You get the following output (note that his score hasn’t increased yet):

{
    [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]

You can verify that his score has changed with the following query:

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

You get the following output:

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