Conceitos básicos do Amazon DocumentDB - Amazon DocumentDB

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conceitos básicos do Amazon DocumentDB

Há muitas formas de se conectar e começar a usar o Amazon DocumentDB. Criamos esse guia porque descobrimos que essa é a maneira mais rápida, simples e fácil para os usuários começarem a usar nosso poderoso banco de dados de documentos. Este guia usa o Amazon Elastic Compute Cloud (AmazonEC2) para conectar e consultar seu cluster Amazon DocumentDB diretamente do. AWS Management Console Novos clientes qualificados para o nível AWS gratuito podem usar o Amazon DocumentDB e a Amazon EC2 gratuitamente. Se seu EC2 ambiente Amazon ou cluster Amazon DocumentDB fizer uso de recursos além do nível gratuito, você pagará AWS as taxas normais desses recursos. Esse guia ajudará você a começar a usar o Amazon DocumentDB em menos de 15 minutos.

nota

As instruções fornecidas nesse guia são específicas para criar e se conectar a clusters baseados em instâncias do Amazon DocumentDB. Se você quiser criar e se conectar aos clusters elásticos do Amazon DocumentDB, consulte Como iniciar com clusters elásticos do Amazon DocumentDB.

Se você preferir se conectar ao Amazon DocumentDB a partir de sua máquina local criando uma SSH conexão com uma EC2 instância da Amazon, consulte Conecte usando o Amazon EC2

Pré-requisitos

Antes de criar o primeiro cluster do Amazon DocumentDB, você deve fazer o seguinte:

Crie uma conta (AWS) da Amazon Web Services

Antes de começar a usar o Amazon DocumentDB, você deve ter uma conta da Amazon Web Services (AWS). A AWS conta é gratuita. Você paga apenas pelos serviços e recursos usados.

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

Para se inscrever em um Conta da AWS
  1. Abra a https://portal.aws.amazon.com/billing/inscrição.

  2. Siga as instruções online.

    Parte do procedimento de inscrição envolve receber uma chamada telefônica e inserir um código de verificação no teclado do telefone.

    Quando você se inscreve em um Conta da AWS, um Usuário raiz da conta da AWSé criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

Configure as permissões necessárias AWS Identity and Access Management (IAM).

O acesso para gerenciar recursos do Amazon DocumentDB, como clusters, instâncias e grupos de parâmetros de cluster, requer credenciais que AWS possam ser usadas para autenticar suas solicitações. Para obter mais informações, consulte Gerenciamento de identidade e Gerenciamento de acesso para o Amazon DocumentDB.

  1. Na barra de pesquisa do AWS Management Console, digite IAM e selecione IAMno menu suspenso exibido.

  2. Quando estiver no IAM console, selecione Usuários no painel de navegação.

  3. Selecione o nome de usuário.

  4. Clique no botão Adicionar permissões.

  5. Selecione Attach existing policies directly (Anexar políticas existentes diretamente).

  6. Digite AmazonDocDBFullAccess na barra de pesquisa e selecione-a quando ela aparecer nos resultados da pesquisa.

  7. Clique no botão azul na parte inferior que diz Avançar: Revisão.

  8. Clique no botão azul na parte inferior que diz Adicionar permissões.

Crie uma Amazon Virtual Private Cloud (AmazonVPC)

Sua AWS conta inclui um padrão VPC em cada região. Essa etapa só é necessária se você optar por usar uma Amazon padrãoVPC. Nesse caso, conclua as etapas no VPC tópico Criar uma Amazon no Guia do VPC usuário da Amazon.

Inicie uma EC2 instância da Amazon

Conclua as etapas 1 e 2 do EC2 tópico Comece a usar a Amazon no Guia do usuário do Amazon Elastic Compute Cloud.

Etapa 1: criar um cluster do Amazon DocumentDB

Nesta etapa, você criará um cluster do Amazon DocumentDB.

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

    Empty Clusters dashboard with options to create a new cluster and manage resources.
  2. Na página Criar cluster do Amazon DocumentDB, na seção Tipo de cluster, escolha Clusters baseados em instância (essa é a opção padrão).

    Cluster type selection with Instance Based Cluster option highlighted and described.
  3. Na seção Configuração:

    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.

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

    4. 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.

    Configuration form for a database cluster with fields for identifier, version, instance class, and number.
  4. Na seção Configuração de armazenamento do cluster, escolha Amazon DocumentDB Padrão (essa é a opção padrão).

  5. Na seção Conectividade:

    1. Selecione Conectar a um recurso EC2 computacional.

    2. Em EC2Instance, selecione a EC2 instância em que você criouPré-requisitos.

    Connectivity settings for database with options to connect or not connect to an EC2 compute resource.
  6. Na seção Autenticação, insira as credenciais de login.

    Authentication form with username and password fields, including input requirements.
  7. Deixe todas as outras opções conforme o padrão e escolha Criar cluster.

nota

Quando você configura uma conexão entre uma EC2 instância e um banco de dados Amazon DocumentDB, o Amazon DocumentDB configura automaticamente VPC o grupo de segurança para EC2 sua instância e para seu banco de dados Amazon DocumentDB. Para obter mais informações, consulte Visão geral da conectividade automática com uma instância do EC2.

O Amazon DocumentDB agora está provisionando seu cluster, o que pode levar alguns minutos para ser concluído. Você pode se conectar ao seu cluster quando o status do cluster e da instância forem disponível.

nota

Para obter informações sobre os valores de status do cluster, consulte Valores de status do cluster no capítulo Monitoramento do Amazon DocumentDB.

Para obter informações sobre os valores de status da instância, consulte Valores de status de instâncias no capítulo Monitoramento do Amazon DocumentDB.

Etapa 2: Instalar o shell mongo

Instale o shell mongo na sua EC2 instância da Amazon que você criou. Pré-requisitos O shell do Mongo é um utilitário de linha de comando que você usa para se conectar e consultar seu cluster do Amazon DocumentDB.

Conecte-se à sua EC2 instância da Amazon e, no prompt de comando, crie o arquivo do repositório com o seguinte comando:

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

Quando estiver concluído, instale o shell do mongo com o seguinte comando:

sudo yum install -y mongodb-org-shell

Etapa 3: Conectar-se ao cluster do Amazon DocumentDB

Conecte-se ao seu cluster do Amazon DocumentDB usando o shell mongo instalado na etapa 2.

  1. No console de gerenciamento do Amazon DocumentDB, em Clusters, localize seu cluster. Escolha o cluster que você criou clicando no identificador do cluster.

    DocumentDB cluster management interface showing a regional cluster with primary instance details.
  2. Encryption-in-transit está habilitado por padrão no Amazon DocumentDB. Opcionalmente, você pode desativarTLS. Para baixar o certificado atual necessário para se autenticar em seu cluster, na guia Conectividade e segurança, na seção Conectar-se, em Baixar o certificado da autoridade de certificação (CA) do Amazon DocumentDB necessário para autenticação em seu cluster, copie o comando fornecido. Volte para sua EC2 instância da Amazon e cole o comando.

    Command to download Amazon DocumentDB Certificate Authority (CA) certificate for cluster authentication.
  3. Retorne ao seu cluster no console do Amazon DocumentDB, na guia Conectividade e segurança, na seção Connect, em Connect to this cluster with the mongo shell, copie a string de conexão fornecida. Omita a cópia <insertYourPassword> para que a solicitação de senha seja feita através do shell do mongo quando você se conectar.

    MongoDB connection string for connecting to a DocumentDB cluster using the mongo shell.

    Volte para sua EC2 instância da Amazon e cole a string de conexão.

Quando você insere sua senha e aparece rs0:PRIMARY> em seu prompt, a conexão ao seu cluster do Amazon DocumentDB é bem-sucedida.

nota

Para obter mais informações sobre solução de problemas, consulte Solução de problemas do Amazon DocumentDB.

Etapa 4: Inserir e consultar dados

Agora que você está conectado ao seu cluster, pode executar algumas consultas para se familiarizar com o uso de um banco de dados de documentos.

  1. Para inserir um único documento, digite o seguinte:

    db.collection.insert({"hello":"DocumentDB"})
  2. Você obterá o seguinte resultado:

    WriteResult({ "nInserted" : 1 })
  3. É possível ler o documento que escreveu com o comando findOne() (porque ele retorna apenas um único documento). Insira o seguinte:

    db.collection.findOne()
  4. Você obterá o seguinte resultado:

    { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
  5. 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} ])
  6. Você obterá o seguinte resultado:

    { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }
  7. Use o find() comando para retornar todos os documentos na coleção de perfis. Insira o seguinte:

    db.profiles.find()
  8. Você obterá um resultado que corresponderá aos dados digitados na Etapa 5.

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

    db.profiles.find({name: "Katie"})
  10. Você deve obter este resultado:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
  11. Agora vamos tentar encontrar um perfil e modificá-lo usando o comando findAndModify. Atribuiremos ao usuário Matt mais dez pontos com o seguinte código:

    db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } })
  12. 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 }
  13. É possível verificar se a pontuação dele mudou com a seguinte consulta:

    db.profiles.find({name: "Matt"})
  14. Você obterá a seguinte saída:

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

Etapa 5: Explorar

Parabéns! Você concluiu com êxito o Guia de conceitos básicos do Amazon DocumentDB.

E depois? Saiba como aproveitar ao máximo esse banco de dados com alguns de seus atributos populares:

nota

O cluster que você criou a partir desse exercício introdutório continuará gerando custos, a menos que seja excluído. Para obter instruções, consulte Exclusão de um cluster do Amazon DocumentDB.