快捷導航

MongoDB集合重命名的完整指南

更新時間：2025年11月21日 10:11:14 作者：Seal^_^

本文全面介紹了MongoDB集合重命名操作,包含以下核心內(nèi)容：?兩種重命名方式：同數(shù)據(jù)庫（僅更新元數(shù)據(jù)）和跨數(shù)據(jù)庫（實際數(shù)據(jù)遷移）?詳細命令語法和參數(shù),需要的朋友可以參考下

1. 集合重命名架構(gòu)總覽

2. renameCollection命令詳解

2.1 命令語法結(jié)構(gòu)

db.adminCommand({
  renameCollection: "<source_db>.<source_collection>",
  to: "<target_db>.<target_collection>",
  dropTarget: <boolean>,  // 可選
  stayTemp: <boolean>     // 可選(4.4+)
})

2.2 參數(shù)說明表格

參數(shù)	類型	必填	描述	默認值
renameCollection	string	是	源集合完全限定名	-
to	string	是	目標集合完全限定名	-
dropTarget	boolean	否	是否覆蓋目標集合	false
stayTemp	boolean	否	是否保留臨時狀態(tài)	false

3. 重命名操作流程圖

4. 不同場景下的重命名操作

4.1 同數(shù)據(jù)庫重命名

// 基本語法
db.adminCommand({
  renameCollection: "test.products_old",
  to: "test.products_new"
})

// 驗證結(jié)果
use test
show collections

例子：

db.adminCommand({
  renameCollection: "mytest_db.products",
  to: "mytest_db.products_new"
})

// 驗證結(jié)果
show collections

4.2 跨數(shù)據(jù)庫重命名

// 跨數(shù)據(jù)庫重命名
db.adminCommand({
  renameCollection: "dev.users",
  to: "prod.customers"
})

// 強制覆蓋目標集合
db.adminCommand({
  renameCollection: "dev.logs",
  to: "prod.app_logs",
  dropTarget: true
})

5. 重命名操作特性

5.1 保留的集合屬性

屬性	是否保留	備注
文檔數(shù)據(jù)	是	全部遷移
索引	是	包括自定義索引
分片配置	否	需重新配置
視圖依賴	否	需手動更新
驗證規(guī)則	是	保持原樣

5.2 性能影響對比

操作類型	鎖級別	資源消耗	耗時
同DB重命名	全局寫鎖	低	快
跨DB重命名	全局寫鎖	高(數(shù)據(jù)復制)	慢

6. 權(quán)限與安全配置

6.1 所需權(quán)限矩陣

操作	源DB權(quán)限	目標DB權(quán)限
同DB重命名	`renameCollection`	-
跨DB重命名	`readWrite`	`dbAdmin`

6.2 創(chuàng)建專用角色

use admin
db.createRole({
  role: "collectionAdmin",
  privileges: [
    {
      resource: { db: "", collection: "" },
      actions: ["renameCollection"]
    }
  ],
  roles: []
})

7. 高級應(yīng)用場景

7.1 臨時集合處理

// 創(chuàng)建臨時集合
db.temp_data.insertMany([...])

// 重命名并保留臨時狀態(tài)(4.4+)
db.adminCommand({
  renameCollection: "test.temp_data",
  to: "test.final_data",
  stayTemp: true
})

7.2 大規(guī)模集合重命名策略

8. 故障排查與恢復

8.1 常見錯誤代碼

錯誤代碼	原因	解決方案
26	命名空間不存在	檢查源集合名
48	目標已存在	使用dropTarget或先刪除
73	無效名稱	檢查命名規(guī)范
13	權(quán)限不足	提升用戶權(quán)限

8.2 操作回滾方案

// 1. 檢查oplog獲取操作時間點
use local
db.oplog.rs.find({op: "c", ns: "admin.$cmd"}).sort({$natural: -1}).limit(1)

// 2. 執(zhí)行反向重命名
db.adminCommand({
  renameCollection: "test.new_name",
  to: "test.original_name",
  dropTarget: true
})

9. 最佳實踐建議

生產(chǎn)環(huán)境操作清單：

業(yè)務(wù)低峰期執(zhí)行
提前備份數(shù)據(jù)
通知相關(guān)團隊
準備回滾方案

命名規(guī)范建議：

// 好的命名
db.adminCommand({renameCollection: "analytics.user_logs", to: "analytics.user_events"})

// 不好的命名
db.adminCommand({renameCollection: "db1.col1", to: "db2.1234"})

監(jiān)控指標：

# 監(jiān)控集合重命名操作
mongotop -n 10
mongostat --discover -n 5

10. 替代方案比較

方案	優(yōu)點	缺點	適用場景
renameCollection	原子操作,保留索引	需要停機	中小集合
mongodump+mongorestore	可選擇性遷移	耗時較長	超大集合
應(yīng)用層雙寫	無需停機	實現(xiàn)復雜	關(guān)鍵業(yè)務(wù)集合