IBM Cloud Docs
Introdução ao Databases for MongoDB

Introdução ao Databases for MongoDB

Este tutorial o orienta nas etapas para começar a usar rapidamente o Databases for MongoDB provisionando uma instância, definindo sua senha de administrador, conectando-se a ela e escrevendo e lendo um documento simples.

Siga estas etapas para concluir o tutorial:

Siga estas etapas para concluir o tutorial:

Siga estas etapas para concluir o tutorial:

Siga estas etapas para concluir o tutorial:

Antes de Iniciar

Passo 1: Escolha o seu plano

Databases for MongoDB oferece dois planos diferentes:

Usando APIs

Use o API do Cloud Databases. para trabalhar com a sua instância do Databases for MongoDB A API do controlador de recurso é usada para provisionar uma instância

Você precisará de uma chave de API para executar ações por meio da API. Siga estas etapas para criar uma IBM Cloud que lhe permita usar a API para provisionar a infraestrutura em sua conta. É possível criar até 20 chaves API.

Por motivos de segurança, a chave API está disponível apenas para ser copiada ou transferida por download no momento da criação. Se a chave API for perdida, uma nova chave API deverá ser criada.

Etapa 2: Provisionar por meio do console

  1. Efetue login no console do IBM Cloud.

  2. Clique no serviço Databases for MongoDB no catalog.

  3. Siga estas etapas para provisionar uma instância de Databases for MongoDB.

  4. Quando sua instância for provisionada, clique no nome da instância para visualizar mais informações.

Etapa 2: Provisionar por meio da CLI

É possível provisionar uma instância do Databases for MongoDB usando a CLI. Se você ainda não o tiver, será necessário instalar a IBM Cloud CLI.

Você pode seguir estas etapas para provisionar uma instância de Databases for MongoDB.

Etapa 2: Provisionar por meio da API do controlador do recurso

Siga estas etapas para provisionar uma instância de Databases for MongoDB usando a API do controlador de recursos.

Etapa 2: Provisionar por meio do Terraform

Você precisa de uma chave de API para executar ações via Terraform. Siga estas etapas para criar uma IBM Cloud que permita que o Terraform provisione a infraestrutura em sua conta. É possível criar até 20 chaves API.

Por motivos de segurança, a chave API está disponível apenas para ser copiada ou transferida por download no momento da criação. Se a chave API for perdida, uma nova chave API deverá ser criada.

Depois que você tiver uma chave de API, siga estas etapas para provisionar uma instância de Databases for MongoDB usando o Terraform.

Etapa 3: Defina a senha do administrador

O usuário administrativo

Quando você provisiona uma implantação Databases for MongoDB, um usuário admin é criado automaticamente.

Configure a senha do administrador antes de usá-la para se conectar

Defina a senha do administrador por meio da interface do usuário

Defina sua senha de administrador por meio da interface do usuário, selecionando sua instância na IBM Cloud lista de recursos. Em seguida, selecione Configurações.. Em seguida, selecione Alterar Senha do Administrador de Banco de Dados.

Definir a senha do administrador por meio da CLI

Use o comando cdb user-password do plug-in IBM Cloud CLI Cloud Databases para configurar a senha do administrador.

Por exemplo, para definir a senha de administrador para sua implementação, use o seguinte comando:

ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>

Definir a senha do administrador por meio da API

Você pode usar o parâmetro id obtido na resposta da Etapa 2 acima com o ponto de extremidade Set specified user's password para definir a senha do administrador.

curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
     -d '{"password":"newrootpasswordsupersecure21"}' \
      "https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"

O parâmetro id precisa ser URL-encoded para que a chamada de API acima funcione.

Configuração da senha de administrador por meio do Terraform

A senha do administrador é passada como um dos parâmetros de recurso do banco de dados no script do Terraform. Não há necessidade de nenhuma ação adicional.

Etapa 4: Conecte-se à sua instância Databases for MongoDB

Você pode se conectar facilmente à sua instância usando o Mongo Shell (uma interface de linha de comando) ou o Mongo Compass, uma GUI avançada para consultar e analisar seus dados. Essas duas ferramentas são fornecidas pelo meu MongoDB.

Usando o Mongo Shell

Siga estas instruções para fazer download e conectar-se ao Mongo Shell.

Em seguida, você pode testar sua implementação inserindo um documento em uma coleção:

use sample_mflix

db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

O comando acima alterna para um banco de dados chamado sample_mflix (e o cria se ele ainda não existir) e, em seguida, insere um documento na coleção movies (que também é criada se ainda não existir).

Em seguida, você pode recuperar o documento com:

db.movies.find( { title: "The Favourite" } )

Agora você se conectou ao seu banco de dados e escreveu e leu dados usando o Mongo Shell.

Usando o MongoDB Compass

Siga estas instruções para baixar o MongoDB Compass e usá-lo para se conectar à sua instância Databases for MongoDB. Você pode gravar e ler dados usando a documentação do MongoDB Compass.

Próximas etapas