数据库工作台（Database Workbench，简称 DBW）是一款面向多类型数据库生命周期管理的统一云管理平台。您可以通过 DBW，帮助您快速远程连接和在线管理 MongoDB 数据库。本文介绍如何通过 DBW 连接 MongoDB 实例。

背景信息

数据库工作台 DBW 是集数据库图形用户界面（GUI）、故障排查和审计于一体的数据库 SaaS 产品，提供全方位观测分析、智能风险检核和自治运维等 Web 终端管理能力，为您提供稳定、安全和高效的数据库管理云服务。更多详情，请参见什么是数据库工作台。

前提条件

• 已创建 MongoDB 实例。实例创建方法，请参见创建实例。
• 已为 MongoDB 实例设置数据库登录账密。具体操作步骤，请参见创建账号。
• 实例状态需为运行中。关于实例状态的更多信息，请参见实例状态说明。

注意事项

• 当您选中授权数据库工作台将服务 IP 添加到对应数据库实例白名单时，数据库工作台 DBW 后台服务宿主机的 IP 地址将被添加至数据库实例的白名单中。该白名单的名称格式为 DBW_Sole_***_***_***_Mongo。
• 使用 DBW 连接 MongoDB 过程中，请勿修改、解绑或删除上述白名单，否则将无法打开新的命令窗口执行命令，但当前窗口仍可以继续执行命令操作。
• 不支持通过 DBW 登录已开通 SSL 加密服务的 MongoDB 实例。如需登录，请先关闭实例的 SSL 加密服务，关闭方法，请参见设置 SSL 加密。
  如果通过 DBW 成功连接 MongoDB 实例后又为实例开启了 SSL 加密服务，那么原连接不会断开仍可以继续执行其他命令，但无法再打开新的命令窗口。
• DBW 暂未支持个人认证账号使用，因此暂不支持个人认证账号通过 DBW 连接 MongoDB 实例。如需使用该功能，请先将个人认证升级为企业认证。

通过 MongoDB 控制台登录 DBW

1. 登录 MongoDB 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
4. 在目标实例类型列表页找到目标实例，单击右侧操作列中的登录工作台。
5. 在弹出的对话框中，设置如下实例连接参数。

   参数	说明
   实例类型	默认选中文档数据库 MongoDB 版，您无需设置保持默认即可。
   实例名称	默认选中步骤 4 中的目标 MongoDB 实例。 如需登录其他 MongoDB 实例，请从下拉列表中选中对应 MongoDB 实例。
   节点 ID	从下拉列表中选择目标节点 ID。 MongoDB 实例架构不同，支持选择的目标节点也不同，其中： MongoDB 副本集实例 您可以从下拉列表中指定需要连接的节点类型，包括副本集实例的主节点（Primary）和从节点（Secondary）。 说明 若选择了使用从节点（Secondary）连接实例，由于该节点默认不接受任何读请求，因此您需提前在该节点上执行 rs.slaveOK() 后才支持查看该节点下的数据库、集合和索引，但不支持增删改操作。 MongoDB 分片集群实例 您可以从下拉列表中指定需要连接的 Mongos 节点。
   数据库账号	输入数据库账号。当前仅支持使用 root 账号连接实例。
   数据库密码	输入数据库账号对应的密码。 若忘记了密码，您可以通过 MongoDB 控制台修改密码，具体操作步骤，请参见重置密码。

6. 勾选授权数据库工作台将服务 IP 添加到对应数据库实例白名单，单击登录。

   说明

   您也可以同时勾选记住密码，勾选后，后续通过相同账号登录该 MongoDB 实例时无需再输入密码。

通过 DBW 控制台连接 MongoDB 实例

1. 登录 DBW 控制台。
2. 在顶部菜单栏，选择目标 MongoDB 实例所属的项目和地域。
3. 在左侧导航栏，选择数据管理 > 数据交互台。
4. 在弹出的对话框中，设置如下实例连接参数。

   参数	说明
   实例类型	从下拉列表中选择文档数据库 MongoDB 版。
   实例名称	从下拉列表中选择目标 MongoDB 实例。
   节点 ID	从下拉列表中选择目标节点 ID。 MongoDB 实例架构不同，支持选择的目标节点也不同，其中： MongoDB 副本集实例 您可以从下拉列表中指定需要连接的节点类型，包括副本集实例的主节点（Primary）和从节点（Secondary）。 说明 若选择了使用从节点（Secondary）连接实例，由于该节点默认不接受任何读请求，因此您需提前在该节点上执行 rs.slaveOK() 后才支持查看该节点下的数据库、集合和索引，但不支持增删改操作。 MongoDB 分片集群实例 您可以从下拉列表中指定需要连接的 Mongos 节点。
   数据库账号	输入数据库账号。当前仅支持使用 root 账号连接实例。
   数据库密码	输入数据库账号对应的密码。 若忘记了密码，您可以通过 MongoDB 控制台修改密码，具体操作步骤，请参见重置密码。

5. 勾选授权数据库工作台将服务 IP 添加到对应数据库实例白名单，单击登录。

   说明

   您也可以同时勾选记住密码，勾选后，后续通过相同账号登录该 MongoDB 实例时无需再输入密码。

后续操作

通过 DBW 成功连接 MongoDB 实例后，您可以在 DBW 数据交互台的命令窗口执行各类命令语句。同时，您也可以对数据库、集合、索引进行可视化地管理（如创建、查询、删除等）操作。具体操作步骤，请参见：

• 命令操作
• 数据库管理
• 集合管理
• 索引管理