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

定義

compact: 不要なディスク領域をオペレーティングシステムに解放しようとします。

互換性

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

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

重要

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

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

構文

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

db.runCommand(
   {
     compact: <string>,
     dryRun: <boolean>,
     force: <boolean>, // Optional
     freeSpaceTargetMB: <int>, // Optional
     comment: <any>, // Optional
   }
)

コマンドフィールド

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

フィールド	タイプ	説明
`compact`	string	コレクションの名前。
`dryRun`	ブール値	バージョン8.0の新機能。有効にすると、 `compact`コマンドは、対象コレクションから圧縮によって再利用できる領域の推定値（バイト単位）を返します。 `dryRun`を`true`に設定して`compact`を実行すると、MongoDB は推定値のみを返し、圧縮は実行しません。デフォルト: False
`force`	ブール値	オプション。有効にすると、レプリカセット内のプライマリで `compact` が強制的に実行されます。`compact` は、圧縮中のデータベース上のMongoDB CRUD 操作をブロックしません。
`freeSpaceTargetMB`	整数	任意。圧縮を続行するために回復可能な必要があるストレージ領域の最小量をメガバイト単位で指定します。デフォルト：20
`comment`	any	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

`compact` 必要な特権

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

システムコレクションの場合は、次の操作を行う必要があります。

システムコレクションでの compact アクションを許可するカスタムロールを作成します。
そのロールを新規または既存のユーザーに付与します。
そのユーザーとして認証を受け、compact コマンドを実行します。

例として、以下の操作では、指定されたデータベースとコレクションに対して compact アクションの権限を付与するカスタムロールが作成されます。

use admin
db.createRole(
  {
    role: "myCustomCompactRole",
    privileges: [
      {
        resource: { "db" : "<database>" , "collection" : "<collection>" },
        actions: [ "compact" ]
      }
    ],
    roles: []
  }
)

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

既存のユーザーに dbAdmin、hostManager、またはカスタムロールを付与するには、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"
     ]
   }
)

動作

進行状況のモニタリング

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

操作の終了

db.killOp() メソッドで compact を終了するか、操作の完了前にサーバーを再起動すると、compact が終了します。操作によってディスク領域がオペレーティングシステムに返されない場合があります。

ディスクスペース

compact コマンドは、廃棄されたブロックをオペレーティングシステムに解放することにより、コレクション内のデータとインデックスのディスク領域を削減しようとします。効果は、解放可能なブロックの数とデータファイル内のロケーションによって異なります。

コレクションのストレージ容量の変化を確認するには、圧縮の前後でcollStats コマンドを実行します。出力メトリクスcollStats.freeStorageSize を使用して、再利用可能なストレージの量を確認できます。

この操作は反復的であり、各パスでデータファイルのセグメントで機能します。compact が解放するスペースの量を見積もるには、dryRun フラグを使用します。コレクションで compact を呼び出すと、コレクションとそれに関連するインデックスの両方が圧縮されます。

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

バックアップ

圧縮は定期的にデータベースをチェックポイントしますが、これは同期のオーバーヘッドにつながる場合があります。トラフィックの多いデータベースでは、バックアップの取得などの運用タスクが遅れたり、妨げられたりする可能性があります。予期せぬ混乱を避けるため、バックアップを取る前に圧縮を無効にしてください。

マルチシャードトランザクション

注意

配置でセカンダリ読み取りとマルチシャードトランザクションを使用している場合は、compact の代わりに最初の同期の実行を検討してください。

compact の実行時には、WireTiger は compact ワークロードに対応するため、一時的にブロックマネージャー戦略を調整します。この調整により、チェックポイント操作が遅くなり、ノードがトランザクションをコミットするまでの時間が長くなる可能性があります。トランザクションのコミットの遅延は、読み取りレイテンシ、レプリケーションラグ、および運用キューイングの大幅な増加を引き起こす可能性があります。

レプリカセット

レプリカセットのコレクションとインデックスに compact を使用できますが、次の点を考慮してください。

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

クラスター上で compact を実行するには、次の手順で行います。

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

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

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

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

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

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

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

セカンダリノードは compact の実行中でも複製できます。
読み取りは許可されています。

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

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

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

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

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

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

同時圧縮コマンドは許可されていない

同じコレクションで複数の compact コマンドを同時に実行しようとすると、MongoDB はエラーを返します。

例

コレクションの圧縮

次の操作では movies コレクションに対して compact コマンドを実行します。

db.runCommand( { compact: "movies" } )

{ bytesFreed: 27859, ok: 1 }

圧縮の推定

次の操作は、movies コレクションに対して compact コマンドの dry run を実行します。

db.runCommand( {
   compact: "movies",
   dryRun: true
} )

{ estimatedBytesFreed: 27859, ok: 1 }

詳細

autoCompact

戻る

collMod

compactStructuredEncryptionData

定義

互換性

重要

構文