listCollections (Listar Coleções)
Última atualização: 2026-10-09
listCollections (Listar Coleções)
listCollections lista as coleções do banco com suas opções (validador, collation, TTL, etc.). No mongosh use db.getCollectionNames() para apenas nomes ou db.getCollectionInfos() para detalhes. O argumento filter estreita por nome ou tipo (ex.: apenas views). Os resultados voltam como um cursor a ser iterado.
| Categoria | Comandos de Administração |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.runCommand({ listCollections: 1, filter: { name: /^orders/ } })
db.getCollectionInfos({ name: /^orders/ })⚙️ Parâmetros
| filter | Filtra por nome, tipo, opções, etc. |
|---|---|
| nameOnly | Defina true para retornar apenas os nomes. |
Retorno：Retorna um cursor cujo firstBatch contém name, type e options por coleção
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// listCollections: imprime todos os nomes de coleções
use shop
db.getCollectionInfos().forEach((c) => print(c.name))Saída：
orders
products
users📌 Notas
- Os resultados são um cursor; itere firstBatch para tudo
- filter suporta name, type e options
- Coleções system.* são incluídas por padrão; filtre por nome para excluí-las
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QlistCollections vs getCollectionNames?
AgetCollectionNames retorna apenas nomes; listCollections inclui opções por coleção.
QPosso filtrar por views?
AUse filter: { type: 'view' } para listar apenas views.
QO que ele retorna?
AUm cursor; itere firstBatch para os metadados das coleções.
