Docs 菜单
Docs 主页
/
MongoDB Compass

连接至 MongoDB

在此页面上

  • Considerations
  • 连接
  • 从命令行连接至 Compass

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

注意

MongoDB Atlas

如果您需要创建 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 支持的连接字符串选项的完整列表,请参阅 GitHub 上的 Compass 连接自述文件

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

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

4

使用颜色下拉菜单为连接选择标签颜色。当您连接到某人连接时,标签颜色与您引用的标签页的背景颜色相同。

5

如果要将连接保存为常用连接,请在模式中勾选 Favorite this connection 选项。

6

单击 SaveSave & Connect 进入 Compass 主页

重要

必需的访问权限

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

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

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

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

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

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

提示

另请参阅:

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

后退

版本功能