本文介绍如何在文档数据库 MongoDB 版数据交互台执行命令操作。 ## 前提条件 * 已创建 MongoDB 实例，且实例处于运行中。详细操作，请参见[创建实例](../6447/100727)。 * 已创建数据库账号，且账号具有执行对应命令的权限。详细操作，请参见[创建账号](../6447/71102)。 ## 注意事项 * 查询结果最多支持显示 3000 行，单行数据上限是 3 MB，结果集上限是 10 MB。 * SQL 窗口中最多可以打开 10 个 Tab，为了不影响数据库的运行，请及时关闭一些 Tab。 * 在 SQL 窗口中，右键单击 Tab 页，可以实现关闭当前会话，关闭其他会话，关闭右侧会话或关闭所有会话的功能。 * 由于 DBW 无法保证在数据交互台的 SQL 窗口中执行的 SQL 能达到最佳性能。因此，建议您不要在数据交互台的 SQL 窗口中执行对响应延迟较为敏感型的 SQL 任务。 * 在 SQL 窗口中，每个 Tab 页对应的物理连接不唯一。因此在执行事务时，推荐全部选中事务语句一次性执行；避免逐条执行时物理连接变更，使后续执行语句失效。 * 您执行的创建、删除等操作可能会对线上业务运行造成影响，建议选择业务低峰期进行。 * 您可以在数据交互台的可操作区域，按需切换数据库和集合。最多支持显示 100 个数据库或集合。 * 多条命令一起执行时，所有命令都会执行，但仅展示最后一条命令的结果。若需要查看某条指定命令的执行结果，需单独执行该命令。 * 支持通过 `CMD + Enter` 快捷键执行指定 SQL 语句。 * `use`、`set`、`it` 和 `show` 系列命令不能与其他命令一起执行，若需执行请单次执行。 * 在执行数据库命令时，如果命令执行失败，并提示无对应权限，请参考[修改](https://www.volcengine.com/docs/6447/1328812)[账号](https://www.volcengine.com/docs/6447/1328812)[权限](https://www.volcengine.com/docs/6447/1328812)修改登录账号的数据库权限。 * 目前在文档数据库 MongoDB 数据交互台中不支持执行以下命令，如有命令支持需求，请[提交工单](https://console.volcengine.com/workorder/create)联系技术支持，或者使用开源工具如 [Compass](https://github.com/mongodb-js/compass/releases?page=5)、[DataGrip](https://www.jetbrains.com/datagrip/download/?section=mac) 或 [Stadio 3T](https://robomongo.org/download.php) 接入火山引擎文档数据库 MongoDB。 |**命令形式** |**子命令** | |---|---| |db.runCommand({$command}) |`shutdownServer`、`applyOps`、`replSetAbortPrimaryCatchUp`、`replSetFreeze`、`replSetGetConfig`、`replSetInitiate`、`replSetMaintenance`、`replSetReconfig`、`replSetStepDown`、`replSetSyncFrom`、`replSetAbortPrimaryCatchUp`、`addShard`、`balancerStart`、`balancerStop`、`checkShardingIndex`、`moveChunk`、`movePrimary`、`mergeChunks`、`removeShard`、`setShardVersion`、`split`、`splitVector`、`unsetSharding`、`print` | |db.adminCommand({$command}) |`clone`、`cloneDatabase`、`cloneCollection`、`cloneCollectionAsCapped`、`compact`、`logRotate`、`reIndex`、`shutdown` | |db.$command |`db.shutdownServer()`、`db.cloneDatabase("hostname")`、`db.cloneCollection("test")` | |rs.$command |`rs.freeze`、`rs.initiate`、`rs.reconfig`、`rs.stepDown`、`rs.add`、`rs.addArb`、`rs.syncFrom` | |sh.$command |`addShard`、`moveChunk`、`movePrimary`、`mergeChunks`、`removeShard`、`setShardVersion`、`split`、`splitVector`、`unsetSharding` | ## 操作步骤 1. 登录[文档数据库 MongoDB 版数据交互台](../6956/257744)。 2. 在**数据交互台**页面的命令执行区域，编辑 SQL 语句，然后单击**执行**。 :::tip 您也可以选中目标 SQL 语句，然后单击**执行**，执行部分语句。 ::: 成功执行后，您可以进行以下操作： * **查看运行记录和执行结果**：在运行记录区域查看运行记录，在执行结果区域查看命令的运行结果。同时，您也可以单击**关闭全部**，关闭执行结果标签页。 * **下载执行结果**：在执行结果区域，对于执行成功的结果，您可以单击**下载**，将执行结果以 result.json 文件保存到本地。 * **复制执行结果**：在执行结果区域，对于执行成功的结果，您可以单击**复制**，复制当前的执行结果数据。 * **收藏 SQ**L：单击会话窗口右上角的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1653cb4aef411ee36c305340aa15245a.png =15x) 图标，在**收藏 SQL** 控制面板，设置以下参数信息后，单击**确定**。 * **SQL** **名称**：自定义 SQL 语句的名称，不可为空。 * **生效范围**：选择收藏的 SQL 语句生效的范围，当前支持选择在**当前库**和**当前实例**中生效。 * **SQL** **语句**：您可以在 SQL 语句区域中修改需要收藏的 SQL 文本。 * **查看收藏的 SQL 语句**：单击会话窗口右上角的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ea80a67c40ff91675b90aaa1b20469ee.png =15x) 图标，在**收藏夹**控制面板，您可以**查看**、**编辑**和**删除**已收藏的 SQL 语句。 * **查看 SQL 执行记录**：单击会话窗口右上角的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0dc8b1b2bb2c62d9d0abc49afeeef830.png =15x) 图标，在执行历史控制面板，您可以按需筛选指定时间内在所有窗口内执行的 SQL 语句。成功执行后，您可以在**执行结果**区域查看输出结果，在**运行记录**中查看执行记录，也可以单击**清空记录**删除执行记录。 ## 相关 API |**API** |**描述** | |---|---| |[DataExecCommands](../6956/152609) |调用 DataExecCommands 接口执行命令语句。 | |[DataSessionKeepAlive](../6956/152610) |调用 DataSessionKeepAlive 接口保持 SQL 会话窗口。 | |[DataCloseSession](../6956/152611) |调用 DataCloseSession 接口退出 SQL 会话窗口。 | |[DataCancelExec](../6956/152612) |调用 DataCancelExec 接口取消 SQL 执行。 |

数据库工作台