Início Rápido: Criar um cluster do Azure DocumentDB usando o portal do Azure

Neste início rápido, você criará um novo cluster do Azure DocumentDB. Esse cluster contém todos os recursos típicos do MongoDB: bancos de dados, coleções e documentos. O cluster fornece um ponto de extremidade exclusivo para várias ferramentas e drivers se conectarem ao Azure DocumentDB e executarem operações diárias.

Pré-requisitos

• Uma assinatura do Azure

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita

Criar um cluster

Para começar, primeiro você precisa criar um cluster do Azure DocumentDB, que serve como base para armazenar e gerenciar seus dados NoSQL.

1. Entre no portal do Azure (https://portal.azure.com).

2. No menu do portal do Azure ou na Home page, selecione Criar um recurso.

3. Na página Novo , pesquise e selecione o Azure DocumentDB.

   

4. Na página Criar cluster do Azure DocumentDB e na seção Configurações básicas, selecione a opção Configurar na seção Camada Cluster.

   

5. Na página Dimensionar , configure essas opções e, em seguida, selecione Salvar para persistir suas alterações na camada de cluster.

   	Value
   Nível do cluster	M30 tier, 2 vCore, 8-GiB RAM
   Armazenamento por fragmento	128 GiB

   

6. De volta à seção Noções básicas , configure as seguintes opções:

   	Value
   Subscription	Selecione sua Assinatura do Azure.
   Grupo de recursos	Crie um novo grupo de recursos ou escolha um grupo de recursos existente
   Nome do cluster	Forneça um nome global exclusivo
   Localidade	Escolha uma região do Azure compatível com sua assinatura
   Versão do MongoDB	Selecione 8.0
   Nome de usuário do administrador	Criar um nome de usuário para acessar o cluster como administrador de usuário
   Senha	Usar uma senha exclusiva associada ao nome de usuário

   

   Dica

   Registre os valores usados para nome de usuário e senha. Esses valores são usados posteriormente neste guia. Para obter mais informações sobre valores válidos, consulte as limitações do cluster.

7. Selecione Avançar: Rede.

8. Na seção Regras de Firewall na guia Rede , configure estas opções:

   	Value
   Método de conectividade	Public access
   Permitir acesso público de serviços e recursos do Azure dentro do Azure para esse cluster	Habilitado

9. Adicione uma regra de firewall para o dispositivo cliente atual para conceder acesso ao cluster selecionando + Adicionar endereço IP do cliente atual.

   

   Dica

   Em muitos ambientes corporativos, os endereços IP do computador do desenvolvedor ficam ocultos devido a uma VPN ou outras configurações de rede corporativa. Nesses casos, você pode permitir temporariamente o acesso a todos os endereços IP adicionando o 0.0.0.0 - 255.255.255.255 intervalo de endereços IP como uma regra de firewall. Use essa regra de firewall apenas temporariamente como parte do teste de conexão e do desenvolvimento.

10. Selecione Examinar + criar.

11. Examine as configurações fornecidas e selecione Criar. São necessários alguns minutos para criar o cluster. Aguarde a conclusão da implantação do recurso.

12. Por fim, selecione Ir para o recurso para navegar até o cluster do Azure DocumentDB no portal.

Obter credenciais do cluster

Obtenha as credenciais que você usa para se conectar ao cluster.

1. Na página do cluster, selecione a opção Cadeias de conexão no menu de recursos.

2. Na seção Cadeias de conexão , copie ou registre o valor do campo Cadeia de conexão .

Conectar usando o Shell do MongoDB no Início Rápido

Para se conectar diretamente ao Azure DocumentDB usando o Shell do MongoDB, use a experiência de Início Rápido disponível na página do recurso no portal do Azure.

1. Na página de recursos do cluster, selecione Início rápido (versão prévia) no menu de navegação.

2. Em seguida, selecione Abrir shell do MongoDB.

3. Aguarde o início do ambiente do Shell do MongoDB.

4. Quando o ambiente estiver pronto, insira Y para aceitar o aviso.

   Observação

   Se você estiver enfrentando um problema de conexão usando o MongoDB Shell depois de aceitar o aviso, verifique se o Azure Cloud Shell tem acesso ao cluster.

5. Agora, insira sua senha para conectar seu cluster ao Cloud Shell.

Executar consultas de teste

Verifique se você está conectado com êxito ao cluster executando uma série de comandos e consultas de teste.

1. Verifique o status da conexão executando o connectionStatus comando.

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Liste os bancos de dados em seu cluster.

   show dbs
   

3. Mude para um banco de dados específico. Substitua o marcador <database-name> pelo nome de um banco de dados qualquer em seu cluster.

   use <database-name>
   

   Dica

   Por exemplo, se o nome do banco de dados for inventory, o comando será use inventory.

4. Liste as coleções no banco de dados.

   show collections
   

5. Localize os cinco primeiros itens em uma coleção específica. Substitua o marcador <collection-name> pelo nome de qualquer coleção em seu cluster.

   db.<collection-name>.find().limit(5)
   

   Dica

   Por exemplo, se o nome da coleção for equipment, o comando será db.equipment.find().limit(5).

Limpar os recursos

Quando terminar de usar o cluster do Azure DocumentDB, você poderá excluir os recursos do Azure criados para não incorrer em mais encargos.

1. Na barra de pesquisa do portal do Azure, procure e selecione Grupos de recursos.

   

2. Na lista, selecione o grupo de recursos criado neste início rápido.

   

3. Na página Grupo de recursos, selecione Excluir grupo de recursos.

4. Na caixa de diálogo de confirmação de exclusão, insira o nome do grupo de recursos para confirmar que você pretende excluí-lo. Por fim, selecione Excluir para excluir permanentemente o grupo de recursos.

   

Conteúdo relacionado

• Conectar através do Shell do MongoDB
• Conectar-se do Azure Cloud Shell
• Migrar dados para o Azure DocumentDB