compact

項目一覧

定義

互換性
構文
コマンドフィールド
compact 必要な特権
動作

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

定義

compact: コレクション内のすべてのデータとインデックスを書き換えてデフラグします。 WiredTigerデータベースでは、このコマンドにより不要なディスク領域をオペレーティングシステムに解放します。

互換性

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

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

重要

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

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

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

{ compact: <collection name> }

コマンドフィールド

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

注意

MongoDB 4.2 以降

MongoDB では、compact の MMAPv 1ストレージエンジンと MMAPv 1の特定オプションpaddingFactor 、 paddingBytes 、 preservePaddingが削除されます

フィールド	タイプ	説明
`compact`	string	コレクションの名前。
`force`	flag	任意。 v4.4 以降では、指定すると、レプリカセット内の`compact` プライマリでが強制的に実行されます。 v4 より前。4 、このブール値フィールドは、値がの場合、レプリカセット内のプライマリでの実行が有効になり、値が`compact` の場合はプライマリで実行するとエラーが返されました。コマンドは他のすべてのコマンドをブロックしたためです。の操作です。`truefalse` v4.4 以降、`compact` は圧縮中のデータベース上のMongoDB CRUD操作をブロックしません。
`comment`	any	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。バージョン 4.4 で追加。

`compact` 必要な特権

認証を強制するクラスターの場合、対象のコレクションでcompact特権アクションが可能なユーザーとして認証を受ける必要があります。 dbAdminロールは、システム以外のコレクションに対してcompactを実行するために必要な権限を提供します。

resourceドキュメントの構成の詳細については、自己管理型配置に関するリソースドキュメントを参照してください。

既存のユーザーに dbAdmin またはカスタムロールを付与するには、 db.grantRolesToUser() または db.updateUser() を使用します。次の操作では、admin データベース上の myCompactUserにカスタムロール compact が付与されます。

use admin
db.grantRolesToUser("myCompactUser", [ "dbAdmin" | "myCustomCompactRole" ] )

新規ユーザーに dbAdmin またはカスタムロールを付与するには、ユーザーの作成時に db.createUser() メソッドの roles 配列でロールを指定します。

use admin
db.createUser(
  {
     user: "myCompactUser",
     pwd: "myCompactUserPassword",
     roles: [
       { role: "dbAdmin", db: "<database>" } | "myCustomCompactRole"
     ]
   }
)

動作

ブロッキング

ブロッキング動作はバージョンに固有です。

バージョン	ブロッキング動作
4.4	`compact` 次の操作をブロックします。 `db.collection.drop()` `db.collection.createIndex()` `db.collection.createIndexes()` `db.collection.dropIndex()` `db.collection.dropIndexes()` `collMod` 他のすべての操作は許可されます。
4.4.17と5.0.12の投稿	`compact` 次の操作をブロックします。 `db.collection.drop()` `db.collection.createIndex()` `db.collection.createIndexes()` `db.collection.dropIndex()` `db.collection.dropIndexes()` `collMod` 他のすべての操作は許可されます。ロックの順序が変更されます。

レプリカセットで compact を実行するには、「レプリカセット」で追加の考慮事項を参照してください。

進行状況のモニタリング

compact 操作の進行状況を確認するには mongod ログファイルを監視するか、別の shell インスタンスから db.currentOp() を実行します。

操作の終了

db.killOp()メソッドを使用してcompactを終了するか、操作が完了する前にサーバーを再起動すると、 compactは終了し、ディスク領域をオペレーティングシステムに解放しようとする際に失敗する可能性があります。

ディスクスペース

コレクションのストレージスペースの変化の推移を確認するには、圧縮の前後に collStats コマンドを実行します。

WiredTigerでは、 compactはコレクション内のデータとインデックスに必要なストレージ領域を削減し、不要なディスク領域をオペレーティングシステムに解放しようと試みますこの操作の有効性はワークロードによって異なります。また、ディスク容量が復元されることはありません。このコマンドは、コレクションから大量のデータを削除し、それを置き換える予定がない場合に便利です。

compact WiredTiger データベースで実行するには追加のディスク領域が必要になる場合があります。

レプリカセット

レプリカセットに格納されているコレクションとインデックスに対して compact を使用できますが、いくつか重要な考慮事項があります。

compact コマンドはプライマリノードからセカンダリノードに複製されることはありません。
可能な場合は常にセカンダリノードで compact を実行する必要があります。セカンダリで compact を実行できない場合は、強制オプションを参照してください。
MongoDB 5.0.12 以降
- セカンダリノードは compact の実行中でも複製できます。
- 読み取りは許可されています。

クラスター上で compact を実行するには

セカンダリノードを圧縮します。

セカンダリノードの一つで compact を実行します。compact が終了したら、残りのセカンダリのそれぞれに対して順に操作を繰り返します。

プライマリノードを再度割り当てます。

現在のプライマリノードを解任して選挙をトリガーするには、 rs.stepDown() メソッドを使用します。特定のセカンダリノードを指名するには、ノードの優先順位を調整します。

古いプライマリを圧縮します。

解任後、旧プライマリノードはセカンダリノードになります。旧プライマリ・ノードで compact を実行します。。

セカンダリノードのバージョン固有の考慮事項

セカンダリノードでのブロッキング動作はバージョン固有です。

バージョン	ブロッキング動作
4.4	レプリケーションはできません。読み取りは許可されていません。
4.4.17と5.0.12の投稿	セカンダリノードは `compact` の実行中でも複製できます。読み取りが許可されます。

compactコマンドの実行中、レプリカセットはSECONDARYステータスのままになります。

レプリカセットのノードの状態の詳細については、レプリカセットノードの状態を参照してください。

レプリカセットのメンテナンスと可用性については、自己管理型レプリカセットメンバーのメンテナンスの実行を参照してください。

シャーディングされたクラスター

compactはmongodインスタンスにのみ適用されます。シャーディングされた環境では、メンテナンス操作として各シャードでcompactを個別に実行します。

インスタンスに対してcompact mongosを発行することはできません。

インデックス構築

mongodは、 compact操作の後にすべてのインデックスを並列に再構築します。

戻る

collMod

convertToCapped

定義

互換性

重要

構文