Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

db.getCollectionNames()

Nesta página

  • Definição
  • Acesso necessário
  • Comportamento
  • Exemplo
db.getCollectionNames()

Retorna uma array contendo os nomes de todas as coleções e visualizações no banco de dados atual ou, se estiver executando com controle de acesso, os nomes das coleções, de acordo com o privilégio do usuário. Para obter detalhes, consulte Acesso necessário.

O db.getCollectionNames() é equivalente a:

db.runCommand(
{
listCollections: 1.0,
authorizedCollections: true,
nameOnly: true
}
)
  • Para usuários com o acesso exigido (privilégios que concedem a ação listCollections no banco de dados), o método lista os nomes de todas as collections do banco de dados.

  • Para usuários sem o acesso exigido, o método lista somente as collections para as quais os usuários têm privilégios. Por exemplo, se um usuário tiver find em uma collection específica em um banco de dados, o método retornará apenas essa collection.

A partir do MongoDB 4.2, se o cliente que emitiu db.getCollectionNames() se desconectar antes da conclusão da operação, o MongoDB marcará db.getCollectionNames() para encerramento usando killOp.

Para executar em um nó do conjunto de réplicas, as operações delistCollections exigem que o nó esteja no estado PRIMARY ou SECONDARY. Se o nó estiver em outro estado, como STARTUP2, haverá erros na operação.

O seguinte retorna os nomes de todas as coleções no banco de dados records:

use records
db.getCollectionNames()

O método retorna os nomes das coleções em uma array:

[ "employees", "products", "mylogs", "system.indexes" ]

Voltar

db.getCollectionInfos