setFeatureCompatibilityVersion

设置功能兼容性版本

必需

version 的可能值如下

确认

必需

将 true 设置为确认功能兼容性更改，并允许操作继续。

如果您省略了 confirm 参数或将 confirm 设置为除 true 以外的任何值，则命令失败并返回有关修改功能兼容性版本的警告。警告指出，在您升级或降级集群的fCV 之后，您无法在没有支持协助的情况下降级二进制版本。

writeConcern

可选

《writeConcern》（写关注）指定了以毫秒为单位的写关注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的快速发布版本。

如果您升级或降级部署的fCV，则无法在不从支持人员获得帮助的情况下降级部署的二进制版本。

有关更多信息，请参阅降级7.0到6.0。

与后台操作冲突

某些后台操作可能会阻止执行setFeatureCompatibilityVersion。使用currentOp来识别任何正在进行的操作。

同步失败

如果您在初始同步过程中触发了一个 setFeatureCompatibilityVersion 变更，同步可能会在 oplog 应用阶段重新播放条目时失败，并显示一个 OplogOperationUnsupported 错误消息。由于操作阶段不再重新播放操作，因此尝试后的同步将成功。

默认值

幂等性

此命令必须对内部系统集合执行写入操作。如果由于任何原因命令未成功完成，您可以安全地重试该命令，因为该操作是幂等的。

集群间同步和用户写入阻塞

从 MongoDB 6.0 开始，如果您需要降级功能兼容性版本，请确保您已禁用集群间复制和用户写入阻塞。

1. 如果您启用了集群间复制，请禁用它。

2. 如果您启用了用户写入阻塞，请禁用它

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

3. 等待之前的命令完成。

4. 使用 setFeatureCompatibilityVersion. 降级功能兼容性版本。

有关 MongoDB 集群间同步的更多信息，请参阅文档。

仲裁者中的功能兼容性

仲裁者不复制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" } )

设置写入关注超时

以下示例将可选的写入关注字段 wtimeout 设置为 5000（5 秒）。

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