db.getSiblingDB()

Esta versão da documentação foi arquivada e não é mais suportada. Para atualizar seu sistema do 5.0, consulte osprocedimentos de atualização do MongoDB 6.0 .

Definição

db.getSiblingDB(<database>)

Parâmetro	Tipo	Descrição
`database`	string	O nome de um banco de dados MongoDB.

Retorna:	Um objeto de banco de dados.

Usado para retornar outro banco de dados sem modificar a variável db no ambiente de shell.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Exemplo

Você pode utilizar db.getSiblingDB() como alternativa ao auxiliar use <database>. Isso é particularmente útil ao escrever scripts usando mongosh onde o auxiliar use não está disponível.

Considere uma instância MongoDB com dois bancos de dados, users e records. A coleção active é uma parte do banco de dados users. A coleção requests faz parte do banco de dados records.

Especificar um banco de dados

Essa operação define o objeto db para apontar para o banco de dados chamado userse, em seguida, retorna um document count para a coleção active.

db = db.getSiblingDB('users')
db.active.countDocuments()

Usar vários bancos de dados

Você pode criar vários objetos do db, que se referem a diferentes bancos de dados, como na seguinte sequência de operações:

users = db.getSiblingDB('users')
records = db.getSiblingDB('records')
users.active.countDocuments()
users.active.findOne()
records.requests.countDocuments()
records.requests.findOne()

Esta operação cria dois objetos db. Cada objeto db refere-se a um banco de dados diferente, users ou records.

Para cada banco de dados, a consulta retorna:

um document count e
an example document

de uma coleção nesse banco de dados.

Voltar

db.getReplicationInfo

db.hello