setFeatureCompatibilityVersion

setFeatureCompatibilityVersion

必須

version に指定できる値は次のとおりです。

confirm

必須

機能の互換性の変更を確認し、操作を続行できるようにするには、true に設定します。

confirm パラメーターを省略するか、confirm を true 以外の値に設定すると、コマンドは失敗し、機能の互換性バージョンの変更に関する警告が返されます。警告には、クラスターの fCV をアップグレードまたはダウングレードした後は、バイナリ バージョンをダウングレードするには、サポートによる支援が必要であることが記載されています。

writeConcern

任意

writeConcern は書込み保証 (write concern) の wtimeout の値をミリ秒単位で指定します。

• プライマリが大多数のレプリカセット ノードからの確認を待機する時間です。時間内に確認応答が受信されない場合、操作は失敗します。

• デフォルトは 60000 ミリ秒です。レプリカセットのセカンダリ ノードの遅延が wtimeout のデフォルトを超える場合は、時間を長くします。

下位互換性のないデータによるダウングレード

ダウンロードしたバージョンに互換性のないデータが含まれているクラスターの fCV をダウングレードしようとすると、CannotDowngrade エラーを受領します。このエラーが発生すると、クラスターは過渡的な downgrading 状態のままになります。

クラスターを downgrading 状態から移動するには、次のいずれかを実行します。

• クラスター データを変更して下位互換性のない機能を削除し、ダウングレードされたバージョンで setFeatureCompatibilityVersion コマンドを再実行して、fCV をダウングレードされたバージョンに設定します。

• 元のアップグレード バージョンで setFeatureCompatibilityVersion コマンドを実行し、fCV を元のバージョンに戻します。

  重要

  fCV を元のバージョンに設定すると、ダウングレード手順が停止し、fCV がアップグレードされたバージョンに戻ります。この手順では、クラスターは fCV のダウングレードが開始される前の状態にリセットされません。

  失敗した fCV ダウングレードの内部メタデータがクリーンアップされない場合、次回の fCV のアップグレードの試行はエラーメッセージと共に失敗します。fCV のアップグレードを試す前に、fCV のダウングレードを完了する必要があります。

MongoDB 7.0 でのダウングレード ポリシーの変更

MongoDB 7.0 以降では、配置の fCV を MongoDB の Rapid Release バージョンにダウングレードしたり、Rapid Release バージョンから任意のバージョンにダウングレードしたりすることはできません。

配置の fCV をアップグレードまたはダウングレードする場合、サポートの支援なしに配置のバイナリ バージョンをダウングレードすることはできません。

詳しくは、「7.0 から 6.0 へのダウングレード」を参照してください。

バックグラウンド操作との競合

特定のバックグラウンド操作により、setFeatureCompatibilityVersion の実行が妨げられる可能性があります。実行中の操作を識別するには、currentOp を使用します。

同期の失敗

最初の同期中に setFeatureCompatibilityVersion を起動した場合、oplog アプリケーション フェーズでエントリを繰り返すと、同期が失敗し、OplogOperationUnsupported エラー メッセージが表示される場合があります。操作フェーズで操作が繰り返されなくなるため、このあとの同期は成功します。

Default Values

べき等性

このコマンドは、内部システム コレクションへの書込みを実行する必要があります。何らかの理由でコマンドが正常に完了しない場合は、操作がべき等であるため、安全にコマンドを再試行できます。

Cluster-to-Cluster Sync とユーザー書込み (write) ブロック

MongoDB 6.0 以降では、機能の互換性バージョンをダウングレードする必要がある場合は、クラスター間のレプリケーションとユーザー書込みブロックを無効にしてください。

1. クラスター間のレプリケーションを有効にしている場合は無効にします。

2. ユーザーに書込みブロックを有効にしている場合は、無効にします。

   db.runCommand( { setUserWriteBlockMode: 1, global: false } )

3. 前のコマンドが完了するまで待機します。

4. setFeatureCompatibilityVersion を使用して機能の互換性バージョンをダウングレードします。

MongoDB Cluster-to-Cluster Sync の詳細については、ドキュメントを参照してください。

アービタの機能互換性

アービタは admin.system.version コレクションを複製しません。このため、レプリカセットの fCV 値に関係なく、アービタは常にバイナリのダウングレード バージョンと同じ機能の互換性バージョンを使用します。

たとえば、MongoDB 5.0 クラスターのアービタの fCV 値は 4.4 です。

FeatureCompatibilityVersion の取得

mongod インスタンスの featureCompatibilityVersion を表示するには、mongod インスタンスで getParameter コマンドを実行します。

db.adminCommand(
   {
      getParameter: 1,
      featureCompatibilityVersion: 1
   }
 )

出力は次のようになります。

{
  featureCompatibilityVersion: { version: '5.0' },
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1660318752, i: 5 }),
    signature: {
      hash: Binary(Buffer.from("ce0cff3621e9b089fa6d8e9a1e1efc1a1ff15dab", "hex"), 0),
      keyId: Long("7129893797260951557")
    }
  },
  operationTime: Timestamp({ t: 1660318752, i: 5 })
}

MongoDB 7.0 配置で機能の互換性バージョンを設定する

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "7.0",
      confirm: true
   }
)

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "6.0",
      confirm: true
   }
)

MongoDB 6.0 配置で機能の互換性バージョンを設定する

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

MongoDB 5.0 配置で機能の互換性バージョンを設定する

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )

書込み保証 (write concern) タイムアウトの設定

次の例では、任意の書込み保証 (write concern) の wtimeout フィールドを 5000（5 秒）に設定しています。

db.adminCommand( {
   setFeatureCompatibilityVersion: "5.0",
   writeConcern: { wtimeout: 5000 }
} )