Conceitos básicos do Amazon DocumentDB

Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

No console de gerenciamento do Amazon DocumentDB, em Clusters, escolha Criar.

Na página Criação de cluster do Amazon DocumentDB, na seção Tipo de cluster, escolha Clusters baseados em instâncias (essa é a opção padrão).

Na seção Configuração do cluster:

1. Em Identificador do cluster, insira um nome exclusivo, como mydocdbcluster. Observe que o console mudará todos os nomes de cluster para minúsculas, independentemente de como eles sejam inseridos.

2. Em Versão do mecanismo, escolha 5.0.0.

Na seção Configuração de armazenamento do cluster, escolha Amazon DocumentDB Padrão (essa é a opção padrão).

Na seção Instance configuration:

1. Em Classe de instância de banco de dados, escolha Classes otimizadas para memória (incluir classes r) (esse é o padrão).

   A outra opção de instância são as classes baseadas em NVMe. Para saber mais, consulte Instâncias baseadas em NVMe.

2. Em Classe de instância, escolha db.t3.medium. Isso é elegível para o teste gratuito da AWS.

3. Em Número de instâncias, escolha 1 instância. Escolher uma instância ajuda a minimizar os custos. Se for um sistema de produção, recomendamos que você provisione três instâncias para alta disponibilidade.

Na seção Conectividade, mantenha a configuração padrão Não se conectar a um recurso de computação do EC2.

Na seção Autenticação, insira um nome de usuário para o usuário principal e escolha Autogerenciado. Insira uma senha e confirme-a.

Se, em vez disso, você escolher Gerenciado no AWS Secrets Manager, consulte Gerenciamento de senhas com o Amazon DocumentDB e o AWS Secrets Manager para obter mais informações.

Deixe todas as outras opções conforme o padrão e escolha Criar cluster.

No console de gerenciamento do Amazon DocumentDB, em Clusters, localize o cluster que você criou. Escolha o cluster clicando na caixa de seleção ao lado dele.

Clique em Conectar-se ao cluster (que fica ao lado do menu suspenso Ações). Esse botão será habilitado somente depois que você clicar na caixa de seleção ao lado do seu cluster e o status do cluster regional e da(s) instância(s) primária(S) forem exibidos como Disponível. A tela Executar comando do CloudShell é exibida.

No campo Nome do novo ambiente, insira um nome exclusivo, como "teste" e clique em Criar e executar. Os detalhes do ambiente da VPC são configurados automaticamente para o banco de dados do Amazon DocumentDB.

Quando solicitado, insira a senha que você criou na Etapa 1: criação de um cluster elástico do Amazon DocumentDB (subetapa 7).

Depois de você inserir sua senha e seu prompt se tornar rs0 [direct: primary] <env-name>>, a conexão ao seu cluster do Amazon DocumentDB será concluída com êxito.

Para inserir um único documento, digite o seguinte:

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

Você obterá o seguinte resultado:

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

É possível ler o documento que escreveu com o comando findOne() (porque ele retorna apenas um único documento). Insira o seguinte:

db.collection.findOne()

Você obterá o seguinte resultado:

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

Para realizar mais algumas consultas, considere um caso de uso de perfis de jogos. Primeiro, insira algumas entradas em uma coleção intitulada profiles. Insira o seguinte:

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

Você obterá o seguinte resultado:

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

Use o find() comando para retornar todos os documentos na coleção de perfis. Insira o seguinte:

db.profiles.find()

Você obterá um resultado que corresponderá aos dados digitados na Etapa 3.

Use uma consulta para um único documento por meio de um filtro. Insira o seguinte:

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

Você obterá o seguinte resultado:

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

Agora vamos tentar encontrar um perfil e modificá-lo usando o comando findAndModify. Atribuiremos ao usuário Matt mais 10z pontos com o código a seguir:

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

Você obtém o seguinte resultado (observe que a pontuação dele ainda não aumentou):

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

É possível verificar se a pontuação dele mudou com a seguinte consulta:

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

Você obterá a seguinte saída:

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