Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Métodos de mongosh
/
Bancos de dados

db.getSiblingDB()

Nesta página

  • Definição
  • Compatibilidade
  • Exemplo

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:

de uma coleção nesse banco de dados.

Voltar

db.getReplicationInfo

Próximo

db.hello