collMod

インデックス プロパティを変更する

インデックス オプションを変更するには、変更する既存のインデックス オプションのキー パターンまたは名前のいずれかを指定します。

db.runCommand( {
   collMod: <collection>,
   index: {
      keyPattern: <index_spec> | name: <index_name>,
      expireAfterSeconds: <number>,  // Set the TTL expiration threshold
      hidden: <boolean>,             // Change index visibility in the query planner
      prepareUnique: <boolean>,      // Reject new duplicate index entries
      unique: <boolean>              // Convert an index to a unique index
   },
   dryRun: <boolean>
} )

インデックスが存在しない場合は、コマンドはエラーになり、"cannot find index <name|keyPattern> for ns <db.collection>" というメッセージが表示されます。

index

index オプションは、既存のインデックスの次のプロパティを変更できます。

インデックス プロパティ	説明
expireAfterSeconds	TTL コレクションの有効期限しきい値を決定する秒数。 成功した場合、コマンドは次の内容を含むドキュメントを返します。 expireAfterSeconds_new: 次に対する新しい値: expireAfterSeconds expireAfterSeconds_old: インデックスに以前にexpireAfterSecondsの値があった場合の expireAfterSecondsの古い値。 インデックス オプション expireAfterSeconds を変更すると、インデックスの $indexStats がリセットされます。 MongoDB 5.0 より前のバージョンで作成された TTL インデックスを使用する場合、または MongDB 5.0 で作成されたデータを 5.0 より前のインストールと同期する場合は、「NaN を使用して構成されたインデックス」を参照して誤った構成の問題を回避してください。 TTLインデックスの expireAfterSeconds 値は、0 から 2147483647 の範囲内（両端を含む）である必要があります。
hidden	インデックスがクエリ プランナーから非表示かどうかを決定するブール値。 hidden の値が変更された場合、コマンドは変更されたプロパティの古い値と新しい値の両方（hidden_old と hidden_new）を含むドキュメントを返します。 ただし、hidden 値が変更されていない場合（つまり、すでに非表示になっているインデックスを非表示にしたり、すでに非表示になっていないインデックスを表示したりする場合など）は、コマンドは出力から hidden_old フィールドと hidden_new フィールドを省略します。 インデックスを非表示にするには、featureCompatibilityVersion を 4.4 以上に設定する必要があります。 インデックス オプション hidden を変更すると、値が変更された場合にインデックスの $indexStats がリセットされます。
prepareUnique	インデックスが新しい重複エントリを受け入れるかどうかを決定するブール値。 prepareUnique が true の場合、新しい重複エントリは DuplicateKey エラーで失敗します。結果のインデックスはユニークインデックスに変換できます。インデックスを変換するには、unique オプションとともに collMod を使用します。 既存のインデックスがアップデートされて prepareUnique が true になった場合、そのインデックスには既存の重複するインデックス エントリがチェックされません。 バージョン 6.0 で追加。
unique	インデックスが一意であるかどうかを決定するブール値。 false の値はサポートされていません。 unique が true の場合、collMod は keyPattern インデックスをスキャンして重複を検索し、重複するインデックス エントリがない場合にはユニークインデックスに変換します。 初期スキャン中に重複が検出された場合、collMod は CannotConvertIndexToUnique と競合するドキュメントのリストを返します。重複エントリを含むインデックスをユニークインデックスに変換するには、報告された競合を修正し、collMod を再実行します。 変換を終了するには、prepareUnique を false に設定します。 一意でないインデックスを一意のインデックスに変換する方法の例については、「既存のインデックスを一意のインデックスに変換する 」を参照してください。 バージョン 6.0 で追加。

dryRun

デフォルト値: false

index.uniqueがtrueの場合にのみ使用されます。

一意でないインデックスを一意のインデックスに変換する前に、 dryRun: trueとともにcollModコマンドを実行できます。 そうすると、MongoDB はコレクション内で重複キーをチェックし、違反を返します。

dryRun: trueを使用して、エラーなくインデックスを一意に変換できることを確認します。

ドキュメントを検証する

validator

validator により、ユーザーはコレクションに対して検証ルールまたは式を指定できるようになります。

validator オプションは、検証ルールまたは式を指定するドキュメントを受け取ります。クエリ演算子と同じ演算子を使用して式を指定できます。ただし、$near、$nearSphere、$text、$where は対象外です。

注意

• 検証はアップデートや挿入中に行われます。既存のドキュメントは、変更されるまで検証チェックを受けません。

• admin、local、および config データベース内のコレクションに対してバリデーターを指定することはできません。

• system.* コレクションにバリデーターを指定することはできません。

validationLevel

validationLevel は、アップデート中に MongoDB が既存のドキュメントに検証ルールをどの程度厳密に適用するかを決定します。

"off"

挿入またはアップデートの検証は行われません。

"strict"

デフォルト すべての挿入とすべてのアップデートに検証ルールを適用します。

"moderate"

既存の有効なドキュメントの挿入とアップデートに検証ルールを適用します。既存の無効なドキュメントのアップデートにはルールは適用しません。

validationLevel を使用する例については、「既存のドキュメントの検証レベルを指定する」を参照してください。

validationAction

validationAction オプションは、無効なドキュメントに対して error を実行するか、違反については warn のみを実行して無効なドキュメントを許可するかを決定します。

重要

ドキュメントの検証は、validationLevel によって決定されたドキュメントにのみ適用されます。

validationAction の使用例については、「無効なドキュメントの処理方法を選択する」を参照してください。

ビューを変更する

viewOn

基礎となるソース コレクションまたはビュー。ビュー定義は、指定された pipeline をこのソースに適用することによって決定されます。

アクセス制御を使用して実行されている MongoDB 配置のビューを変更する場合に必要です。

pipeline

ビューを定義する集計パイプライン。

注意

ビュー定義pipelineには、$outまたは$mergeステージを含めることはできません。この制限は、$lookupステージまたは$facetステージで使用されるパイプラインなどの埋め込みパイプラインにも適用されます。

アクセス制御を使用して実行されている MongoDB 配置のビューを変更する場合に必要です。

ビュー定義はパブリックです。つまり、ビューに対する db.getCollectionInfos() および explain操作には、ビューを定義するパイプラインが含まれます。そのため、ビュー定義で機密性の高いフィールドと値を直接参照することは避けてください。

db.runCommand( {
   collMod: "myView",
   viewOn: "activities",
   pipeline: [
     { $match: { status: "Q" } },
     { $project: { user: 1, date: 1, description: 1} } ]
} )

時系列コレクションを変更する

expireAfterSeconds

注意

これは、TTL コレクションの有効期限を変更するために expireAfterSeconds プロパティで index オプションを使用することとは異なります。

自動ドキュメント削除を有効にするか、時系列コレクションの現在の有効期限間隔を変更するには、expireAfterSeconds 値を変更します。

db.runCommand( {
   collMod: <collection>,
   expireAfterSeconds: <number> | "off"
} )

自動削除を無効にするには、expireAfterSeconds を "off" に設定します。または、ドキュメントの有効期限が切れるまでの秒数を指定するには、負ではない 10 進数（>=0）を設定します。

granularity

時系列コレクションの粒度を変更するには、timeseries.granularity を短い時間単位から長い時間単位に増やします。

db.runCommand( {
   collMod: "weather24h",
   timeseries: { granularity: "seconds" | "minutes" | "hours" }
} )

granularity ではなく、カスタム バケット パラメーター bucketRoundingSeconds と bucketMaxSpanSeconds をアップデートするには、両方のカスタム パラメーターを collMod コマンドに含めて、同じ値に設定します。

db.runCommand( {
   collMod: "weather24h",
   timeseries: {
      bucketRoundingSeconds: 86400,
      bucketMaxSpanSeconds: 86400
   }
} )

粒度間隔またはカスタム バケット値を減らすことはできません。

重要

いずれかの時系列コレクションでカスタム バケット パラメーター bucketMaxSpanSeconds および bucketRoundingSeconds が明示的に指定されている場合は、MongoDB 6.3 より下にダウングレードすることはできません。可能であれば、対応する granularityに変換します。可能でない場合は、ダウングレードする前にコレクションを削除する必要があります。

コレクションをカスタム バケットから granularity 値に変換するには、bucketMaxSpanSeconds と bucketRoundingSeconds の両方が granularity と同等かそれ以下である必要があります。

granularity	bucketRoundingSeconds 制限（この値を含む）	bucketMaxSpanSeconds 制限（この値を含む）
seconds	60	3600
minutes	3600	86400
hours	86400	2592000

Tip

以下も参照してください。

時系列データの粒度の設定

上限付きコレクションのサイズを変更する

MongoDB 6.0 以降では、上限付きコレクションのサイズを変更できるようになりました。上限付きコレクションの最大サイズ（バイト単位）を変更するには、cappedSize オプションを使用します。既存の上限付きコレクション内のドキュメントの最大数を変更するには、cappedMax オプションを使用します。

cappedSize

上限コレクションの新しい最大サイズ（単位: バイト）を指定します。cappedSize は 0 より大きく、1e+15（1 PB）より小さくなければなりません。

cappedMax

上限付きコレクション内のドキュメントの新しい最大数を指定します。cappedMax を 0 以下に設定すると、制限がなくなります。

たとえば、次のコマンドは、上限付きコレクションの最大サイズを 100000 バイトに設定し、コレクション内のドキュメントの最大数を 500 に設定します。

db.runCommand( {
   collMod: <collection>,
   cappedSize: 100000,
   cappedMax: 500
} )

変更ストリームにおけるドキュメントの変更前と変更後のイメージ

changeStreamPreAndPostImages

MongoDB 6.0 以降では、変更ストリーム イベントを使用して、変更前と変更後のドキュメントのバージョン（変更前とイメージと変更後のイメージ）を出力できます。

• 変更前のイメージとは、置換、更新、または削除される前のドキュメントです。挿入されたドキュメントには、変更前のイメージはありません。

• 変更後のイメージとは、挿入、置換、または更新された後のドキュメントです。削除されたドキュメントには、変更後のイメージはありません。

• db.createCollection() 、 create 、またはcollModを使用し、コレクションに対してchangeStreamPreAndPostImagesを有効にします。

collMod を使用してコレクションの変更ストリームの事前イメージと事後イメージを有効にするには、changeStreamPreAndPostImages フィールドを使用します。

db.runCommand( {
   collMod: <collection>,
   changeStreamPreAndPostImages: { enabled: <boolean> }
} )

コレクションの変更ストリームの事前イメージと事後イメージを有効にするには、changeStreamPreAndPostImages を true に設定します。例:

db.runCommand( {
   collMod: "orders",
   changeStreamPreAndPostImages: { enabled: true }
} )

コレクションの変更ストリームの事前イメージと事後イメージを無効にするには、changeStreamPreAndPostImages を false に設定します。例:

db.runCommand( {
   collMod: "orders",
   changeStreamPreAndPostImages: { enabled: false }
} )

変更ストリーム イベントにおいて、次の条件に当てはまる場合、変更前と変更後のイメージは使用できません。

• ドキュメントの更新または削除操作時に、コレクションにおいて有効になっていない場合。

• expireAfterSeconds で設定した、変更前と変更後のイメージ保持時間が経過した後に削除された場合。

  • 次の例では、クラスター全体でexpireAfterSecondsを100秒に設定します。

    use admin
    db.runCommand( {
       setClusterParameter:
          { changeStreamOptions: {
             preAndPostImages: { expireAfterSeconds: 100 }
          } }
    } )

  • 次の例では、expireAfterSeconds を含む現在の changeStreamOptions 設定を返します。

    db.adminCommand( { getClusterParameter: "changeStreamOptions" } )

  • expireAfterSeconds を off に設定すると、デフォルトの保持ポリシーが適用されます。対応する変更ストリーム イベントがoplog から削除されるまで、変更前と変更後のイメージは保持されます。

  • 変更ストリーム イベントが oplog から削除されると、 expireAfterSeconds の変更前と変更後のイメージの保持時間にかかわらず、対応する変更前と変更後のイメージも削除されます。

その他の考慮事項

• 変更前と変更後のイメージを有効にすると、ストレージ容量が消費され、処理時間が増えます。変更前と変更後のイメージは、必要な場合のみ有効にしてください。

• 変更ストリーム イベントのサイズを 16 メガバイト未満に制限します。イベントのサイズを制限するには、次の方法があります。

  • ドキュメントのサイズを 8 MB に制限します。updateDescription のような他の変更ストリーム イベントのフィールドがそれほど大きくない場合、変更ストリーム出力で変更前と変更後のイメージを同時にリクエストできます。

  • updateDescription のような他の変更ストリーム イベントのフィールドがそれほど大きくない場合、ドキュメントの変更ストリーム出力では最大 16 MB の変更後のイメージのみをリクエストしてください。

  • 次の場合、ドキュメントの変更ストリーム出力では最大 16 MB の変更前のイメージのみをリクエストしてください。

    • ドキュメントのアップデートがドキュメントの構造または内容のごく一部にしか影響しない場合、そして

    • replace 変更イベントが発生しない場合。replace イベントには、常に変更後のイメージが含まれます。

• 変更前イメージをリクエストするには、db.collection.watch() で、fullDocumentBeforeChange を required または whenAvailable に設定します。変更後イメージをリクエストするには、同じ方法で fullDocument を設定します。

• 変更前のイメージは config.system.preimages コレクションに書き込まれます。

  • config.system.preimages コレクションが大きくなる場合があります。コレクションのサイズを制限するには、前述のとおり、変更前のイメージに expireAfterSeconds 時間を設定します。

  • 変更前のイメージはバックグラウンド プロセスによって非同期で削除されます。

コメントを添付する

comment

任意: このコマンドにコメントを添付できます。コメントは最上位フィールドである必要があり、有効な BSON 型 であれば何でもかまいません。指定したコメントは、このコマンドのレコードの横に次の場所に表示されます。

• attr.command.cursor.comment フィールド内のmongod ログ メッセージ。

• command.comment フィールドのデータベースプロファイラー出力。

• command.comment フィールドのcurrentOp出力。

書込み保証 (write concern)

w

任意: collMod コマンドの書込みの考慮事項を表すドキュメント。

デフォルトの書込み保証を使用する場合は省略します。

リソースのロック

collModコマンドは、操作中に指定されたコレクションのコレクション ロックを取得します。

インデックスの有効期限値を変更する

次の例では、user_log という名前のコレクションの既存の TTL インデックス { lastAccess: 1 } の expireAfterSeconds プロパティをアップデートします。インデックスの現在の expireAfterSeconds プロパティは 1800 秒（または 30 分）に設定されており、この例では値を 3600 秒（または 60 分）に変更しています。

db.runCommand({
   collMod: "user_log",
   index: {
      keyPattern: { lastAccess: 1 },
      expireAfterSeconds: 3600
   }
})

成功した場合、操作は変更されたプロパティの古い値と新しい値の両方を含むドキュメントを返します。

{ "expireAfterSeconds_old" : 1800, "expireAfterSeconds_new" : 3600, "ok" : 1 }

クエリ プランナーからインデックスを非表示にする

次の例では、orders コレクションの既存のインデックスを非表示にします。具体的には、この操作により、仕様 { shippedDate: 1 } のインデックスがクエリ プランナーから非表示になります。

db.runCommand( {
   collMod: "orders",
   index: {
      keyPattern: { shippedDate: 1 },
      hidden: true
   }
} )

成功した場合、操作は変更されたプロパティの古い値と新しい値の両方を含むドキュメントを返します。

{ "hidden_old" : false, "hidden_new" : true, "ok" : 1 }

テキスト インデックスを非表示にするには、keyPattern ではなく name でインデックスを指定する必要があります。