Docs 菜单
Docs 主页
/
MongoDB Compass

连接至 MongoDB

在此页面上

  • 注意事项
  • 连接
  • 从命令行连接至 Compass

本页面概述了如何使用 MongoDB Compass 连接 MongoDB 主机。 您可以连接到独立、副本集或分片集群主机。

注意

MongoDB 阿特拉斯

如果您需要创建 MongoDB 主机,请考虑使用 MongoDB Atlas 。 Atlas 是一种云托管的数据库即服务,无需安装,提供免费入门套餐和可复制的 URI 以轻松将 Compass 连接到您的部署。

如果您需要安装 Compass,请参阅下载和安装 Compass以了解相关说明。

  • 将 Compass 连接到副本集时,不建议直接连接到单个副本集成员。如果由于选举而将您连接的节点从节点切换为从节点(反之亦然),Compass 可能会强行关闭连接或显示过时数据。

    相反,要连接到副本集,请在填写连接信息时使用副本集 SRV recordReplica Set Name

  • 从 MongoDB Compass 1.19 开始, Compass 在连接非正版 MongoDB 实例时会显示警告消息, 因为这些实例的行为可能与正版 MongoDB 实例不同;例如 缺失或不完整的特征、不同的特征行为等。

  • 从 1.39.2 版开始,MongoDB Compass 不再支持从 1.31.0 版之前的 传统连接文件进行迁移。传统连接是指一种 存储在磁盘上的内部 Compass 连接选项格式, 1.39.0 版之后不再支持这种格式。

    如果您在收藏夹中保存了旧版连接,请导出版本 1.39.0 上的连接,将其转换为新格式,然后再更新到 1.39.2 版或更高版本。

如果您的连接名称已在 Compass 窗口的Connections Sidebar中,请单击连接名称进行连接。

否则,您可以通过以下任一方式连接部署:

  • 提供连接字符串。

  • 指定 Advanced Connection Options 。高级连接选项可以让您指定身份验证、TLS/SSL 以及 SSH 连接选项。要了解更多信息,请参阅高级连接选项

注意

从版本1.44.0开始, 您可以通过 Compass 同时连接到多个 MongoDB 实例。

当您提供连接字符串时,Compass 支持 MongoDB 支持的大多数连接字符串选项

默认情况下,Compass 的默认 socketTimeoutMS 值为 60000,或 60 秒。如果您在 Compass 中经常遇到超时,请考虑在连接字符串中将此选项设置为更高的值。

有关 Compass 支持的连接字符串选项的完整列表,请参阅 Compass 连接自述文件 在 GitHub 上。

1

Connections Sidebar的底部面板中,单击Add New Connection打开New Connection模态。

如果Connections Sidebar中已列出连接,请单击 图标,打开New Connection模态。

2

如果您有可用的部署连接字符串,则可以将该字符串直接粘贴到对话框中。您可以使用标准连接字符串格式DNS 种子列表连接格式。

要获取 Atlas 集群的连接字符串:

  1. 前往 Atlas Clusters(集群)视图。

  2. 点击所需集群的 Connect(连接)。

  3. 单击 Connect with MongoDB Compass(连接)。

  4. 复制提供的连接字符串。

警告

如果您点击进入 MongoDB Compass 连接表单,编辑连接字符串, 则 Compass 默认以明文显示凭据。

要编辑连接字符串档案而不暴露密码,请使用 Compass 连接表格上的 Advanced Connection Options > Authentication(高级连接选项 > 身份验证)标签页。

要了解如何为未托管在 Atlas 上的部署格式化连接字符串,请参阅连接字符串 URI 格式

3

使用名称字段输入连接的名称。如果不指定名称,Compass 将使用集群的主机名作为连接名称。

4

使用颜色下拉菜单选择连接的标签颜色。当您连接到连接时,标签颜色是引用您的连接的标签页的背景颜色。

5

如果要将连接保存为收藏夹,请选中模式中的Favorite this connection选项。

6

单击 SaveSave & Connect 进入 Compass 主页

重要

必需的访问权限

连接到 MongoDB 部署后,您可能需要特定的用户角色才能访问各种 Compass 功能。有关 Compass 功能所需角色的更多信息,请参阅所需的访问权限。

高级连接选项提供了将 Compass 连接到 MongoDB 的其他方法。 高级连接选项允许您指定身份验证、TLS/SSL 和 SSH, 从而安全地连接到部署。

详细信息,请参阅高级连接选项。

您可以从命令行启动 Compass 会话。

在企业环境中,脚本启动可以使 Compass 部署更加容易。 例如,要限制对敏感系统的访问, 您可以配置命令行启动,使 Compass 可以在跳板机上运行。

有关详细信息,请参阅从命令行启动 Compass

提示

另请参阅:

要了解如何断开部署,请参阅从 MongoDB 断开连接

后退

版本功能

来年

连接侧边栏