setFeatureCompatibilityVersion

setFeatureCompatibilityVersion

必須

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

confirm

必須

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

If you omit theconfirm parameter or setconfirm to a value other than,true the command fails and returns a warning about modifying the 機能の互換性バージョン.警告には、クラスターの FCV をアップグレードまたはダウングレードした後は、バイナリ バージョンをダウングレードするには、サポートによる支援が必要であることが記載されています。

writeConcern

任意

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

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

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

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

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

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

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

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

  重要

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

  If a failed FCV downgrade's internal メタデータ is not cleaned up, any subsequent FCV upgrade attempt fails with an error message. FCV のアップグレードを試す前に、FCV のダウングレードを完了する必要があります。

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

配置の 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 の詳細については、ドキュメントを参照してください。

アービタの機能互換性

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 }
} )