IBM Cloud Docs
Conexão com o shell MongoDB

Conexão com o shell MongoDB

É possível acessar o seu banco de dados MongoDB por meio de um cliente da linha de comandos, o que permite a interação e o monitoramento diretos das estruturas de dados que são criadas dentro do banco de dados. Utilize-o para consultar e atualizar dados, bem como para executar operações administrativas e monitorar o desempenho

Instalando

O shell MongoDB está disponível como parte da distribuição MongoDB. Faça o download aqui

Conectando

As sequências de conexão são exibidas no painel Terminais da Visão geral de sua implementação, e também podem ser recuperadas a partir do bancos de bancos de dados de nuvem e da API.

As informações que o shell MongoDB precisa para se conectar à sua instância estão na seção "cli" das sequências de conexão. A tabela contém um detalhamento para referência.

informações de conexão do mongo/cli
Nome do campo Index Descrição
Bin O binário recomendado para a criação de uma conexão; nesse caso, mongosh.
Composed Um comando formatado para estabelecer uma conexão com a sua implementação. O comando combina o executável Bin, as configurações de variáveis Environment e usa
Environment Uma lista de chaves/valores configurados como variáveis de ambiente.
Arguments 0... As informações transmitidas como argumentos para o comando mostrado no campo Bin.
Certificate Base64 Um certificado proprietário de serviço usado para confirmar que um aplicativo está se conectando ao servidor apropriado. Ele é codificado em base64.
Certificate Name O nome alocado para o certificado de propriedade do serviço.
Type O tipo de pacote que usa essas informações de conexão; neste caso, cli.
  • 0... indica que pode haver uma ou mais dessas entradas em uma matriz.

MongoDB Exemplo de shell

mongosh -u admin -p $PASSWORD --tls --tlsCAFile c5f07836-d94c-11e8-a2e9-62ec2ed68f84 --authenticationDatabase admin --host replset/bd574ce4-7b36-4274-9976-96db98a3ac10-0.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484,bd574ce4-7b36-4274-9976-96db98a3ac10-1.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484
  • mongosh- O próprio comando.
  • -u - o parâmetro para o nome do usuário.
  • -p - p parâmetro para a senha.
  • --tls --tlsCAFile- O caminho e o nome do certificado de propriedade do serviço para sua implementação.
  • --authenticationDatabase - o banco de dados no qual o usuário e suas credenciais são criados e armazenados.
  • --host - o nome do conjunto de réplicas, seguido por um /, e os hosts dos membros do conjunto de réplicas.

Iniciando o shell MongoDB por meio da CLI do IBM Cloud

Se o MongoDB Shell estiver instalado localmente, você poderá usar o comando ibmcloud cdb deployment-connections para lidar com tudo o que está envolvido na criação da conexão do cliente. Por exemplo, para se conectar a uma implementação denominada "example-mongo" com um "example-user", use o comando a seguir.

ibmcloud cdb deployment-connections --start -u example-user example-mongo

O comando solicita a senha do usuário e, em seguida, executa o cliente de linha de comando MongoDB para se conectar ao banco de dados.

A opção --start deve vir antes dos parâmetros, caso contrário, as informações de conexão serão retornadas e o Shell MongoDB não será iniciado.

Usando o certificado de propriedade do serviço

  1. Copie as informações do certificado a partir do painel Terminais ou do campo Base64 das informações de conexão.
  2. Se necessário, decodifique a sequência Base64 em texto.
  3. Salve o certificado em um arquivo. (É possível usar o nome fornecido ou o seu próprio nome do arquivo).
  4. Forneça o caminho para o certificado no parâmetro --tlsCAFile.

É possível exibir o certificado decodificado para sua implementação com o plug-in da CLI com o comando:

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Ele decodifica o Base64 em texto. Copie e salve a saída do comando em um arquivo e forneça o caminho do arquivo no parâmetro --tlsCAFile.