renameCollection() (Renomear uma Coleção)
Última atualização: 2026-10-09
renameCollection() (Renomear uma Coleção)
renameCollection() renomeia uma coleção, ex.: `db.users.renameCollection('members')`. Dados e índices sobrevivem à renomeação, mas uma colisão de nome gera erro por padrão; passe {dropTarget: true} para remover o alvo primeiro. A coleção fica brevemente indisponível durante a operação, então agende renomeações com cuidado em produção.
| Categoria | Índice e Administração |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.renameCollection(<newName>, { dropTarget: <bool> })⚙️ Parâmetros
| novo nome | O novo nome da coleção (string). |
|---|---|
| dropTarget | Opcional. true remove primeiro um destino existente; o padrão false gera erro. |
Retorno：Objeto de resultado com um status ok.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// renameCollection: renomeia users para members
db.users.renameCollection('members')Saída：
{ ok: 1 }📌 Notas
- A coleção fica brevemente indisponível durante a renomeação
- Um alvo existente gera erro por padrão; passe dropTarget: true
- Atualize também as referências ao nome da coleção no seu código
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO renameCollection perde dados?
ANão — dados e índices são preservados intactos; apenas o nome muda.
QE se o novo nome já existir?
AGera erro por padrão; {dropTarget: true} remove a coleção de mesmo nome primeiro.
QPosso ler/escrever durante uma renomeação?
AA operação é atômica porém bloqueia brevemente a coleção; agende-a fora do pico em produção.
