/ /

/ /

cloneCollectionAsCapped（データベースコマンド）

定義

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

互換性

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

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

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、「サポートされていないコマンド」を参照してください。

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`	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

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

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

動作

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

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

戻る

bulkWrite

collMod