Docs 菜单
Docs 主页
/ /
参考
Docs 主页
/
工具
/
mongosync
/
参考
Docs 主页
/
工具
/
mongosync
/
参考

mongosync 二进制文件

定义

mongosync 二进制文件是 Mongosync 中使用的主节点 (primary node in the replica set)进程。mongosync 将数据从源集群迁移到目标集群，直到您 完成同步。

有关 mongosync 进程的概述，请参阅关于 mongosync。

要开始使用 mongosync，请参阅快速入门指南。

Frequently Asked Questions (FAQ)（常见问题解答 (FAQ)）页面解答了用户提出的有关 mongosync 的问题。

兼容性

  • 有关版本兼容性要求的详细信息，请参阅 MongoDB Server Version Compatibility。

  • mongosync 支持副本集和分片集群。

  • 不支持独立运行的MongoDB实例。在使用 Mongosync 之前，将独立运行实例转换为副本集。

  • mongosync 不支持 Atlas 共享集群或无服务器实例。

  • 有关限制的完整列表，请参阅 Mongosync 限制。

语法

下面的mongosync命令布局已修改以进行显示。 要使用mongosync将cluster0连接到cluster1 ，请在一行中输入以下命令：

mongosync \
      --cluster0 "<cluster0_connection_string>" \
      --cluster1 "<cluster1_connection_string>"

有关如何格式化连接字符串的更多信息，请参阅连接mongosync。

命令行选项

您可以使用命令行配置以下 mongosync 选项。

要从配置文件配置 mongosync，请参阅配置文件。

全局选项

--acceptDisclaimer

接受针对嵌入式验证程序的免责声明。

当 mongosync进程在没有此选项的情况下启动时，系统会提示用户接受每项免责声明。

此选项允许已阅读并接受免责声明的用户接受免责声明并启动 mongosync进程。

要通过配置文件设置 --acceptDisclaimer 选项，请参阅 acceptDisclaimer 设置。

1.9 版本中的新功能。

--cluster0 <uri>

设置第一个集群的连接 URI。在同步过程中，第一个集群既可以作为源，也可以作为目标。在调用 start API 端点时指定源集群和目标集群。

有关连接 mongosync 的更多信息，请参阅连接。

要通过配置文件设置 --cluster0 选项，请参阅 cluster0 设置。

警告

在某些系统上，使用 --cluster0 或 --cluster1 选项在连接字符串中提供的密码，可能会被其他用户调用的系统状态程序（如 ps ）探测到。

可以考虑使用 --config 选项，指定一个包含密码的配置文件。

--cluster1 <uri>

设置第二个集群的连接 URI 。在同步进程中，第二个集群既可以作为源，也可以作为目标。在 start API 端点的调用中指定源集群和目标集群。

有关连接 mongosync 的更多信息，请参阅连接。

要通过配置文件设置 --cluster1 选项，请参阅 cluster1 设置。

警告

在某些系统上，使用 --cluster0 或 --cluster1 选项在连接字符串中提供的密码，可能会被其他用户调用的系统状态程序（如 ps ）探测到。

可以考虑使用 --config 选项，指定一个包含密码的配置文件。

--config <filename>

设置配置文件的路径。

要在迁移期间设置配置文件路径，请参阅在同步期间重新配置 mongosync。

有关更多信息，请参阅配置文件。

--disableMetricsLogging

1.16.0版本新增。

运行Mongosync 二进制文件时禁用指标日志记录。

警告：强烈建议保持指标日志记录处于启用状态，以便进行有效的故障排除和支持。

有关更多信息，请参阅 Mongosync 指标。

要通过配置文件设置 --disableMetricsLogging 选项，请参阅 disableMetricsLogging 设置。

--disableTelemetry

版本 1.4.0 中的新增功能。

禁用收集 mongosync 遥测数据。

默认情况下，mongosync收集匿名的汇总使用数据以改进 MongoDB 产品。当您运行mongosync时，您可以禁用此遥测数据的收集。

要通过配置文件设置 --disableTelemetry 选项，请参阅 disableTelemetry 设置。

要在迁移期间禁用遥测数据收集，请参阅在同步期间重新配置 mongosync。

有关更多信息，请参阅用户数据集合。

--disableVerification

禁用嵌入式验证器。禁用后，mongosync 不会验证迁移。 有关其他验证方法，请参阅验证数据传输。

对于在运行带验证的 mongosync 时遇到 OOM 终止并且无法分配更多资源或无法容忍重新启动验证的客户，此选项提供了一种解决方法。 它允许在禁用验证的情况下完成迁移。 对于后续的重启和撤销，验证保持禁用状态。

初次启动 mongosync 时不应使用此选项。 相反，请使用 /start请求参数 verification.enabled: false禁用验证，因为默认下会启用验证。

要从配置文件禁用验证，请参阅 disableVerification 设置。

1.10 版本中的新增功能。

--help, -h

将使用情况信息打印到 stdout。

--id <id>

为 mongosync 实例设置标识符。

在分片集群上运行多个 mongosync 实例时，使用此选项单独同步分片。

此选项的标识符值必须与同步分片的分片 ID 相对应。如要查找分片 ID，请使用 listShards 命令。

要通过配置文件设置 --id 选项，请参阅 id 设置。

--loadLevel <level>

类型：整型

默认值：3

设置在源集群和目标集群之间同步数据的集群工作负载级别：

  • 4，这是最高设置，最大限度地提高集群工作负载，数据同步的速度最快。

  • 1，这是最低设置，最大限度地减少了集群工作负载，数据同步的速度最慢。

要通过配置文件设置 --loadLevel 选项，请参阅 loadLevel 设置。

要在迁移期间更改负载级别，请参阅在同步期间重新配置 mongosync。

警告

将 loadLevel设置为高于默认值 3 可能会对目标集群性能产生负面影响。

如果源集群存在读取瓶颈或目标集群存在写入瓶颈，则减少 loadLevel 可能会提高性能。

1.4 版本中的新增功能。

--logPath <directory>

设置日志目录的路径。Mongosync 将日志写入此目录中的文件。

有关更多信息，请参阅日志记录。

要通过配置文件设置 --logPath 选项，请参阅 logPath 设置。

要在迁移期间更改日志目录的路径，请参阅在同步期间重新配置 mongosync。

注意

如果使用--logPath选项启动mongosync ，则可以向mongosync进程发送USR1信号以轮换其日志文件：

kill -s USR1 $mongosync_pid

$mongosync_pid 是mongosync进程 ID。

--metricsLoggingFilepath <directory>

1.16.0版本新增。

设置指标日志目录的路径。Mongosync 将指标日志写入此目录中的文件。

有关更多信息，请参阅 Mongosync 指标。

要通过配置文件设置 --metricsLoggingFilepath 选项，请参阅 metricsLoggingFilepath 设置。

--port

默认值：27182

设置HTTP服务器用于 Mongosync HTTP API 的端口。

要通过配置文件设置 --port 选项，请参阅 port 设置。

要在迁移期间更改端口，请参阅在同步期间重新配置 mongosync。

--verbosity <level>

默认值：DEBUG

设置要在日志消息中使用的详细程度。Mongosync 会记录指定级别的所有消息以及较低级别的所有消息。

--verbosity 选项支持以下各值：

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

要通过配置文件设置 --verbosity 选项，请参阅 verbosity 设置。

要在迁移期间更改详细程度级别，请参阅在同步期间重新配置 mongosync。

--version, -v

将 mongosync 版本信息打印到 StdOut。

行为

如需了解更多信息，请参阅 mongosync 行为。

了解详情

后退

参考

来年

行为

在此页面上