Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Conceitos básicos do Amazon DocumentDB

Modo de foco
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á.

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

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 (Amazon EC2) 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 da sua máquina local criando uma conexão SSH com uma EC2 instância da Amazon, consulte. Conecte-se usando a 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 IAM no menu suspenso exibido.

  2. Depois de chegar ao console do IAM, 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.

Como criar uma Amazon Virtual Private Cloud (Amazon VPC)

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

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 EC2 Instance, 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 um nome de usuário para o usuário principal e escolha uma senha AWS gerenciada ou uma senha autogerenciada.

    • Se você escolher a opção AWS Secrets Manager, configure a chave KMS criando sua própria chave ou usando uma chave criada pelo Secrets Manager.

    • Se você optar por autogerenciar a senha do usuário principal, insira a senha e confirme-a.

  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 o grupo de segurança VPC para sua instância EC2 e para seu banco de dados Amazon DocumentDB. Para obter mais informações, consulte Visão geral da conectividade automática com uma EC2 instância.

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. Você também pode desativar o TLS. 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.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.