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.
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
- Copie as informações do certificado a partir do painel Terminais ou do campo Base64 das informações de conexão.
- Se necessário, decodifique a sequência Base64 em texto.
- Salve o certificado em um arquivo. (É possível usar o nome fornecido ou o seu próprio nome do arquivo).
- 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
.