Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
データベース コマンド
/
管理

cloneCollectionAsCapped

項目一覧

  • 定義
  • 互換性
  • 構文
  • 動作

定義

cloneCollectionAsCapped

cloneCollectionAsCappedコマンドは、同じデータベース内の既存の Capped コレクション以外のコレクションから新しい Capped コレクションを作成します。 この操作は、元の非 Capped コレクションには影響しません。

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

重要

This command is not supported in M0, M2, and M5 clusters or in serverless instances. 詳細については、「サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

このコマンドの構文は、次のとおりです。

db.runCommand(
   {
     cloneCollectionAsCapped: <existing collection>,
     toCollection: <capped collection>,
     size: <capped size>,
     writeConcern: <document>,
     comment: <any>
   }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

フィールド
説明
cloneCollectionAsCapped
コピーする既存のコレクションの名前。
toCollection

作成する新しい Capped コレクションの名前。

新しい Capped コレクションの名前は異なるものである必要があり、元の既存コレクションの名前と同じであることはできません。

サイズ
上限付きコレクションの最大サイズ（バイト単位）。
writeConcern
任意。 コマンドの drop書込み保証（ write concern ） を表すドキュメント。デフォルトの書込み保証を使用する場合は省略します。
comment

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

コマンドはexisting collectionをコピーし、 capped sizeによってバイト単位で指定される最大サイズの新しいcapped collectionを作成します。

元の Capped 以外のコレクションを Capped コレクションに置き換えるには、 convertToCappedコマンドを使用します。

動作

capped sizeがソース コレクションのサイズより小さい場合、ソース コレクション内のすべてのドキュメントが宛先の上限付きコレクションに存在することはありません。

これにより、操作中はデータベースの排他ロックが保持されます。同じデータベースをロックする他の操作は、操作が完了するまでブロックされます。データベースをロックする操作の場合、「一般的なクライアント操作によって取得されるロック」を参照してください。

戻る

bulkWrite

次へ

collMod