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. Este guia é 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 [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) para se conectar e consultar seu cluster do Amazon DocumentDB diretamente a partir do Console de gerenciamento da AWS. Novos clientes qualificados para o nível AWS gratuito podem usar o Amazon DocumentDB CloudShell gratuitamente. Se o seu AWS CloudShell ambiente ou cluster do Amazon DocumentDB fizer uso de recursos além do nível gratuito, serão cobradas AWS as taxas normais por esses recursos. Este guia ajudará você a começar a usar o Amazon DocumentDB em menos de cinco minutos.
**nota**
As instruções neste guia são específicas para criar e conectar-se a clusters baseados em instâncias do Amazon DocumentDB, nos quais o Amazon DocumentDB e o Amazon DocumentDB estão disponíveis. AWS CloudShell
Se você quiser criar e se conectar aos clusters elásticos do Amazon DocumentDB, consulte [Como iniciar com clusters elásticos do Amazon DocumentDB](elastic-get-started.md).
Se você estiver localizado nas regiões AWS da China, consulte[Conectar o Amazon EC2 automaticamente](connect-ec2-auto.md).
**Topics**
+ [Pré-requisitos](#quickstart-prerequisites)
+ [Etapa 1: criar um cluster](#get-start-cluster)
+ [Etapa 2: conectar-se ao seu cluster](#get-start-connectcluster)
+ [Etapa 3: inserir e consultar dados](#get-start-insert-query)
+ [Etapa 4: explorar](#get-start-congrats)
+ [Início rápido de uso CloudFormation](quick_start_cfn.md)
## 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 o [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Siga as instruções online.
Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**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, exige 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](security-iam.md).
1. Na barra de pesquisa do Console de gerenciamento da AWS, insira **IAM** e selecione ** IAM ** no menu suspenso exibido.
1. Depois de chegar ao console do IAM, selecione **Usuários** no painel de navegação.
1. Selecione o nome de usuário.
1. Escolha **Adicionar permissões**.
1. Selecione **Anexar políticas diretamente**.
1. Digite `AmazonDocDBFullAccess` na barra de pesquisa e selecione-a quando ela aparecer nos resultados da pesquisa.
1. Escolha **Próximo**.
1. Escolha **Adicionar permissões**.
****
Sua AWS conta inclui uma VPC padrão em cada região. Se você optar por usar uma Amazon VPC, conclua as etapas no tópico [Criação de uma Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) no *Guia do usuário da Amazon VPC*.
## Etapa 1: criar um cluster
Nesta etapa, você criará um cluster do Amazon DocumentDB.
1. Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. No console de gerenciamento do Amazon DocumentDB, em **Clusters**, escolha **Criar**.
1. Na página Criar cluster do Amazon DocumentDB, na ** seção Tipo de ** cluster, escolha ** Instance-based cluster ** (essa é a opção padrão).
**nota**
A outra opção nessa categoria é o **Cluster elástico**. Para saber mais sobre os clusters elásticos do Amazon DocumentDB, consulte [Usando clusters elásticos do Amazon DocumentDB](docdb-using-elastic-clusters.md).
1. 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.
1. Em **Versão do mecanismo**, escolha **5.0.0**.
1. Na seção **Configuração de armazenamento do cluster**, escolha **Amazon DocumentDB Padrão** (essa é a opção padrão).
**nota**
A outra opção nessa categoria é o ** Amazon DocumentDB I/O-Optimized**. Para saber mais sobre as opções, consulte [Configurações de armazenamento de cluster do Amazon DocumentDB](db-cluster-storage-configs.md).
1. 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 ** NVMe-backed classes**. Para saber mais, consulte [NVMe-backed instâncias](db-instance-nvme.md).
1. Em **Classe de instância**, escolha **db.t3.medium**. Isso é elegível para o teste AWS gratuito.
1. 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.
1. Na seção **Conectividade**, mantenha a configuração padrão **Não se conectar a um recurso de computação do EC2**.
1. 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ê escolheu ** Gerenciado em AWS Secrets Manager**, consulte [Gerenciamento de senhas com o Amazon DocumentDB e AWS Secrets Manager](docdb-secrets-manager.md) para obter mais informações.
1. Deixe todas as outras opções conforme o padrão e escolha **Criar cluster**.
O Amazon DocumentDB agora está provisionando seu cluster, o que pode levar alguns minutos para ser concluído.
**nota**
Para obter informações sobre os valores de status do cluster, consulte [Valores de status do cluster](monitoring_docdb-cluster_status.md#monitoring_docdb-status_values) no capítulo Monitoramento do Amazon DocumentDB.
## Etapa 2: conectar-se ao seu cluster
Conecte-se ao seu cluster Amazon DocumentDB usando AWS CloudShell.
1. 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.
1. Escolha ** Conectar 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 de comando CloudShell ** Executar é exibida.
1. No campo **Nome do novo ambiente**, insira um nome exclusivo, como "teste" e escolha **Criar e executar**. Os detalhes do ambiente da VPC são configurados automaticamente para o banco de dados do Amazon DocumentDB.
1. 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] >`, a conexão ao seu cluster do Amazon DocumentDB será concluída com êxito.
**nota**
Para obter mais informações sobre solução de problemas, consulte [Solução de problemas do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/devguide/troubleshooting.html).
## Etapa 3: 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.insertOne({"hello":"DocumentDB"})
```
Você obterá o seguinte resultado:
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. É 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" }
```
1. 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 } }
```
1. Use o `find()` comando para retornar todos os documentos na coleção de perfis. Insira o seguinte:
```
db.profiles.find()
```
Você receberá uma saída que corresponderá aos dados digitados na Etapa 3.
1. 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}
```
1. 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}]
```
1. É 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 }
```
## Etapa 4: explorar
Parabéns\! Você concluiu com êxito o Guia de conceitos básicos para clusters baseados em instâncias do Amazon DocumentDB.
E depois? Saiba como aproveitar ao máximo esse banco de dados com alguns de seus atributos populares:
+ [Gerenciando o Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/devguide/managing-documentdb.html)
+ [Escalabilidade](https://docs.aws.amazon.com/documentdb/latest/devguide/operational_tasks.html)
+ [Fazer backup e restaurar](https://docs.aws.amazon.com/documentdb/latest/devguide/backup_restore.html)
**nota**
O cluster que você criou a partir desse exercício introdutório continuará a gerar custos, a menos que seja excluído. Para obter instruções, consulte [Exclusão de um cluster do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/devguide/db-cluster-delete.html).