Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs 菜单
Docs 主页
/ /
Atlas CLI
/ / / /

Atlas API performanceAdvisor listRecommendedIndexes

公共预览版:请提供反馈:返回Performance Advisor建议的索引。

公共预览版: Atlas API子命令从MongoDB Atlas Admin API自动生成,全面覆盖 Admin API ,目前处于公共预览版(请通过以下网址提供反馈:https://反馈.mongodb.com/forums/930808-Atlas-cli)。Admin API功能有自己的发布生命周期,您可以通过提供的API端点文档链接进行检查。

性能优化顾问会监控 MongoDB 认为其速度缓慢的查询,并建议使用新索引来提高查询性能。要使用此资源,请求的服务帐户或 API 密钥必须具有“项目只读”角色。

1此命令是自动生成的,对应:1 和Atlas API端点 https://www.mongodb.com/zh-cn/docs/api/doc/atlas-admin-api-v2 /operation/operation-listsuggestedindexes 。

有关更多信息和示例,请参阅上面链接的参考API文档。

命令语法
atlas api performanceAdvisor listSuggestedIndexes [options]
名称
类型
必需
说明

--duration

int

false

查询在集群的托管命名空间中查找建议索引的时间长度。此参数以毫秒为单位。

  • 如果不指定 since 参数,则端点将返回涵盖当前时间之前持续时间的数据。

  • 如果您既不指定 duration 也不指定 since 参数,该端点将返回过去 24 小时的数据。

--envelope

envelope

false

指示应用程序是否将响应包装在信封JSON对象中的标志。某些API客户端无法访问权限HTTP响应标头或状态代码。要修复此问题,请在查询中设立Envelope=true。返回结果列表的端点将结果对象用作信封。应用程序将状态参数添加到响应正文中。

--groupId

字符串

true

用于标识项目的唯一 24-十六进制数字字符串。 使用 [/groups](# 标签/Projects/operation/listProjects) 端点检索身份验证的用户有权访问权限的所有项目。

注意:群组和项目是同义词。您的群组 ID 与项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。资源和相应的端点使用“群组”一词。

-h,--help

false

listRecommendedIndexes 帮助

--includeCount

false

标志,用于指示响应是否返回响应中的列项总数 (totalCount)。

--itemsPerPage

int

false

响应每页返回的列项数。

--nExamples

int

false

从建议的索引中受益的示例查询的最大数量。

--nIndexes

int

false

指示要建议的最大索引的数字。

--namespaces

.

false

要从中检索建议索引的命名空间。命名空间由一个数据库和一个集合资源组成,写作 .: <database>.<collection>。要包含多个命名空间,请多次传递该参数,并在每个命名空间之间用 & 符号 (&) 分隔。省略此参数可返回所有命名空间的结果。

-o, --output

字符串

false

首选API格式,可以是 ["JSON", go-template] 此值默认为 "JSON"。

--outputFile

字符串

false

要将API输出写入其中的文件。 当端点的输出为二进制(例如:gzip)且命令未通过管道传输(例如: Atlas command > out.zip)时,需要使用此标志

--pageNum

int

false

显示响应返回的当前总对象集的页面编号。

--pretty

false

指示响应正文是否应采用 prettyprint 格式的标记。

--processId

mongod

true

为MongoDB进程提供服务的托管和端口的组合。托管必须是运行MongoDB进程(mongod或 mongos)的托管的主机名、FQDN、IPv4解决或 IPv6解决。该端口必须是MongoDB进程侦听请求的 IANA 端口。

--since

int

false

查询检索建议索引的日期和时间。此参数以自 [UNIX 纪元](https://en.wikipedia.org/wiki/Unix_time)以来经过的毫秒数表示其值。

  • 如果不指定持续时间参数,端点将返回从 since 值到当前时间的数据。

  • 如果您既不指定 duration 也不指定 since 参数,该端点将返回过去 24 小时的数据。

--version

字符串

false

进行API调用时要使用的API版本 [选项:"2023-01-01"],默认为最新版本或配置文件 api_version 配置值(如果设立了此值),默认为 "2023-01-01"。

名称
类型
必需
说明

-P, --profile

字符串

false

要从您的配置文件中使用的配置文件的名称。要学习;了解Atlas CLI配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings。

atlas api performanceAdvisor listSuggestedIndexes --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId]

在此页面上