$listSampledQueries

本页

定义

语法
行为
访问控制
限制
示例
列出所有集合的采样查询
列出特定集合的采样查询
输出
读取查询
写入查询

定义

$listSampledQueries: 返回所有集合或特定集合的采样查询。采样查询用于由analyzeShardKey命令计算分片键的读写分布指标。

语法

$listSampledQueries 的语法如下

{
   $listSampledQueries: { namespace: <namespace> }
}

行为

要列出单个集合的采样查询，请在 namespace 参数中指定集合。
要列出所有集合的采样查询，请省略 namespace 参数。

访问控制

$listSampledQueries 需要在集群上具有clusterMonitor 角色。

限制

您不能在 Atlas 上使用 $listSampledQueries。多租户配置。
您不能在独立部署上使用 $listSampledQueries。
您不能直接针对 --shardsvr 副本集使用 $listSampledQueries。当在分片集群上运行时，$listSampledQueries 必须在 mongos 上运行。

示例

列出所有集合的采样查询

以下聚合操作列出了副本集中所有集合的所有采样查询

db.aggregate( [  { $listSampledQueries: {  } } ] )

特定集合的采样查询列表

以下聚合操作列出了社交数据库中所有针对 post 集合的采样查询

db.aggregate( [  { $listSampledQueries: { namespace: "social.post" } } ] )

输出

读取和写入查询的输出字段不同。

读取查询

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <find|aggregate|count|distinct>,
   cmd: {
     filter: <object>,
     collation: <object>,
     let: <object>
   },
   expireAt: <date>
}

字段名称	类型	描述
`_id`	UUID	查询的样本ID。
`ns`	字符串	采样集合的命名空间。
`collectionUuid`	UUID	采样集合的ID。
`cmdName`	字符串	采样命令的名称。可以是以下之一 `"find"` `"aggregate"` `"count"` `"distinct"`
`cmd.filter`	对象	如果适用，则运行命令时使用的过滤器。
`cmd.collation`	对象	如果适用，则运行命令时使用的排序。
`cmd.let`	对象	命令运行时使用的自定义变量，如果适用。
`expireAt`	日期	样本过期日期。

编写查询

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <update|delete|findAndModify>,
   cmd: <object>,
   expireAt: <date>
}

字段名称	类型	描述
`_id`	UUID	查询的样本ID。
`ns`	字符串	采样集合的命名空间。
`collectionUuid`	UUID	采样集合的ID。
`cmdName`	字符串	采样命令的名称。可以是以下之一 `"update"` `"delete"` `"findAndModify"`
`cmd`	对象	命令对象
`expireAt`	日期	样本过期日期。

$listLocalSessions

下一步

$listSearchIndexes